> ## Documentation Index > Fetch the complete documentation index at: https://talktohumans.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # List contact views > Use this endpoint to list saved TalkToHumans contact views. ## OpenAPI ````yaml /openapi.yaml get /v1/views openapi: 3.0.3 info: title: TalkToHumans Public API version: 1.0.0 license: name: Proprietary description: > Read and organize the LinkedIn workspace data your team already manages in TalkToHumans: accounts, people, tags, notes, sequence state, conversations, and views. servers: - url: https://api.talktohumans.app description: TalkToHumans API security: - bearerAuth: [] tags: - name: Organization description: Workspace details for the current API key. - name: LinkedIn description: >- Accounts, contacts, companies, and conversations already synced into TalkToHumans. - name: Enrich description: Profile enrichment for LinkedIn people and companies. - name: Views description: Saved TalkToHumans views and lists. paths: /v1/views: get: tags: - Views summary: List contact views description: | Use this endpoint to list saved TalkToHumans contact views. operationId: listViews parameters: - $ref: '#/components/parameters/AccountId' - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Cursor' responses: '200': description: Saved contact views. content: application/json: schema: $ref: '#/components/schemas/ListViewsEnvelope' example: data: views: - id: '789' public_id: mem_2f5e3a4b type: contact view_kind: member name: Relevant leads description: Leads found in my network account: account_id: '42' display_name: Jane Doe provider_account_id: ACoAA000000 owner_user_id: '7' app_url: https://app.talktohumans.app/contacts/mem_2f5e3a4b created_at: '2026-05-12T12:00:00Z' updated_at: '2026-05-12T12:00:00Z' pagination: limit: 10 has_more: false '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalServerError' components: parameters: AccountId: name: account_id in: query description: > LinkedIn account IDs returned by `GET /v1/accounts`. Repeat the query parameter for multiple accounts. The backend also accepts comma-separated values. schema: type: array items: type: string pattern: ^[1-9][0-9]*$ style: form explode: true Limit: name: limit in: query description: Page size. Defaults to 10. Values above 25 are clamped to 25. schema: type: integer minimum: 1 default: 10 maximum: 25 Cursor: name: cursor in: query description: Opaque cursor from the previous response's `pagination.next_cursor`. schema: type: string schemas: ListViewsEnvelope: type: object additionalProperties: false required: - data properties: data: $ref: '#/components/schemas/ListViewsResponse' ListViewsResponse: type: object additionalProperties: false required: - views - pagination properties: views: type: array items: $ref: '#/components/schemas/View' pagination: $ref: '#/components/schemas/Pagination' Error: type: object additionalProperties: false required: - code - message properties: code: type: string description: Machine-readable error code. enum: - unauthorized - forbidden - not_found - bad_request - internal_error - conflict - rate_limit_exceeded - billing_payment_failed - billing_subscription_incomplete - billing_subscription_expired - billing_grace_period - billing_feature_not_available - billing_insufficient_credits - billing_invalid - upstream_error message: type: string description: Human-readable error message. debug: type: string description: Development-only debug details. View: type: object additionalProperties: false required: - id - public_id - type - view_kind - name - account - app_url - created_at - updated_at properties: id: type: string description: >- TalkToHumans view ID. Pass as `view_id` on `GET /v1/contacts` to page through its contacts. public_id: type: string description: >- Public saved-view ID used in app URLs. Also accepted as `view_id` on `GET /v1/contacts`. type: type: string enum: - contact view_kind: type: string enum: - member name: type: string description: type: string nullable: true account: $ref: '#/components/schemas/AccountSummary' app_url: type: string format: uri created_at: type: string format: date-time updated_at: type: string format: date-time Pagination: type: object additionalProperties: false required: - limit - has_more properties: limit: type: integer format: int32 example: 10 has_more: type: boolean next_cursor: type: string description: Cursor for the next page. Omitted when there are no more results. AccountSummary: type: object additionalProperties: false required: - account_id - display_name - provider_account_id - owner_user_id properties: account_id: type: string description: TalkToHumans account ID. display_name: type: string provider_account_id: type: string description: LinkedIn provider account ID. owner_user_id: type: string description: TalkToHumans user ID that owns the account. responses: BadRequest: description: Invalid request parameters. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: bad_request message: Invalid request parameters Unauthorized: description: Missing, malformed, or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missingAuthorization: value: code: unauthorized message: Authorization header is required invalidAuthorizationFormat: value: code: unauthorized message: Authorization header must use Bearer scheme invalidAPIKey: value: code: unauthorized message: Invalid API key Forbidden: description: >- API access is not enabled for the workspace, or the credential cannot access the requested workspace. content: application/json: schema: $ref: '#/components/schemas/Error' examples: forbidden: value: code: forbidden message: you don't have access to this organization featureUnavailable: value: code: billing_feature_not_available message: >- Feature 'TalkToHumansAPI' is not available in your current plan insufficientCredits: value: code: billing_insufficient_credits message: Insufficient credits RateLimited: description: >- Rate limit exceeded. Public routes allow 50 requests per 10 seconds per IP and endpoint. headers: Retry-After: description: Seconds to wait before retrying the request. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: code: rate_limit_exceeded message: Rate limit exceeded InternalServerError: description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: internal_error message: An internal error occurred securitySchemes: bearerAuth: type: http scheme: bearer description: 'Pass your API key as `Authorization: Bearer `.' ````