> ## 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 messages > Lists messages from a LinkedIn conversation ## OpenAPI ````yaml /developers/openapi.yaml get /v1/conversations/{conversationId}/messages openapi: 3.0.3 info: title: TalkToHumans Public API version: 1.0.0 license: name: Proprietary description: > Read and organize the LinkedIn organization data your team already manages in TalkToHumans: accounts, contacts, tags, notes, sequence state, conversations, templates, and views. servers: - url: https://api.talktohumans.app description: TalkToHumans API security: - bearerAuth: [] tags: - name: Organization description: Organization details for the current API key. - name: LinkedIn description: LinkedIn accounts, contacts, companies, and conversations. - name: Activity description: Activity for organization reporting. - name: Enrich description: Profile enrichment for LinkedIn contacts and companies. - name: Views description: Saved TalkToHumans views. - name: Templates description: Message and sequence templates. paths: /v1/conversations/{conversationId}/messages: get: tags: - LinkedIn summary: List messages description: Lists messages from a LinkedIn conversation operationId: listConversationMessages parameters: - name: conversationId in: path required: true description: Conversation ID returned by `GET /v1/conversations`. schema: type: string - name: account_id in: query required: true description: LinkedIn account ID returned by `GET /v1/accounts`. schema: type: string pattern: ^[1-9][0-9]*$ - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Cursor' responses: '200': description: Messages in the conversation. content: application/json: schema: $ref: '#/components/schemas/ListConversationMessagesEnvelope' example: data: message_sync_status: synced messages: - message_id: 123:message:urn:li:msg_message:abc provider_message_id: urn:li:msg_message:abc conversation_id: chat_abc123 text: >- Thanks for connecting! Would Tuesday work for a quick call? direction: received sent_at: '2026-10-13T09:00:00Z' is_edited: false is_deleted: false attachments: [] pagination: limit: 10 has_more: false '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/AccountScopedForbidden' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalServerError' components: parameters: 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: ListConversationMessagesEnvelope: type: object additionalProperties: false required: - data properties: data: $ref: '#/components/schemas/ListConversationMessagesResponse' ListConversationMessagesResponse: type: object additionalProperties: false required: - message_sync_status - messages - pagination properties: message_sync_status: $ref: '#/components/schemas/MessageSyncStatus' messages: type: array items: $ref: '#/components/schemas/ConversationMessage' 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 - account_shared_access_required - billing_payment_failed - billing_subscription_incomplete - billing_subscription_expired - billing_grace_period - billing_feature_not_available - billing_insufficient_credits - billing_invalid - enrichment_failed - enrichment_in_progress - linkedin_profile_not_found message: type: string description: Human-readable error message. debug: type: string description: Development-only debug details. MessageSyncStatus: type: string description: > Whether the conversation's recent messages are synced. TalkToHumans reads conversations gradually, newest first, a few at a time while the user's browser is open. - `synced`: recent messages are up to date. - `outdated`: a newer message is still syncing. - `not_synced`: no message has been synced yet. Only recent messages sync automatically; older history loads when the conversation is opened in TalkToHumans. While the status is not `synced`, messages may be incomplete. enum: - synced - outdated - not_synced ConversationMessage: type: object additionalProperties: false required: - message_id - provider_message_id - conversation_id - direction - sent_at - is_edited - is_deleted - attachments properties: message_id: type: string description: TalkToHumans message ID. provider_message_id: type: string description: LinkedIn provider message ID. conversation_id: type: string description: TalkToHumans conversation ID. text: type: string direction: type: string enum: - sent - received sent_at: type: string format: date-time is_edited: type: boolean is_deleted: type: boolean sender_participant_id: type: string description: LinkedIn participant ID for the sender when available. attachments: type: array items: $ref: '#/components/schemas/ConversationMessageAttachment' 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. ConversationMessageAttachment: type: object additionalProperties: false required: - attachment_id - kind - sort_order properties: attachment_id: type: string description: TalkToHumans attachment ID. provider_attachment_id: type: string description: LinkedIn provider attachment ID. kind: type: string sort_order: type: integer format: int32 title: type: string subtitle: type: string description: type: string url: type: string format: uri thumbnail_url: type: string format: uri mime_type: type: string file_name: type: string size_bytes: type: integer format: int32 width: type: integer format: int32 height: type: integer format: int32 duration_ms: type: integer format: int32 responses: BadRequest: description: Invalid request. `message` explains what to fix. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: bad_request message: invalid type for field "account_id" Unauthorized: description: Missing, malformed, invalid, or retired local 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 AccountScopedForbidden: description: >- API access is not enabled for the organization, the API key cannot resolve to an active organization user, or the credential cannot access the requested LinkedIn account. content: application/json: schema: $ref: '#/components/schemas/Error' examples: accountSharedAccessRequired: summary: Requested account is not accessible to this credential value: code: account_shared_access_required message: >- This account is not shared-access enabled for API or MCP. Ask an admin to enable shared access before using this account from this credential. 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 apiKeyPrincipalInvalid: value: code: forbidden message: >- This API key is no longer linked to an active organization user. Ask an organization admin to regenerate it NotFound: description: Requested resource was not found. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: not_found message: participant not found 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 API key as `Authorization: Bearer `.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.