---
title: "List conversation messages"
method: GET
path: "/v1/conversations/{conversationId}/messages"
tags: ["LinkedIn"]
---

# List conversation messages

`GET /v1/conversations/{conversationId}/messages`

## Request

- Base URL: `https://api.talktohumans.app`
- URL: `https://api.talktohumans.app/v1/conversations/{conversationId}/messages`
- Auth: HTTP bearer

Lists messages from a LinkedIn conversation.

## Path parameters

- `conversationId` string, required

## Query parameters

- `account_id` string, required
- `limit` integer
- `cursor` string

## Response `200`

Messages in the conversation.

- ListConversationMessagesEnvelope
  - `data` ListConversationMessagesResponse, required
    - `messages` ConversationMessage[], required
      - `message_id` string, required: TalkToHumans message ID.
      - `provider_message_id` string, required: LinkedIn provider message ID.
      - `conversation_id` string, required: TalkToHumans conversation ID.
      - `text` string
      - `direction` 'sent' | 'received', required
      - `sent_at` string, date-time, required
      - `is_edited` boolean, required
      - `is_deleted` boolean, required
      - `sender_participant_id` string: LinkedIn participant ID for the sender when available.
      - `attachments` ConversationMessageAttachment[], required
        - `attachment_id` string, required: TalkToHumans attachment ID.
        - `provider_attachment_id` string: LinkedIn provider attachment ID.
        - `kind` string, required
        - `sort_order` integer, required
        - `title` string
        - `subtitle` string
        - `description` string
        - `url` string, uri
        - `thumbnail_url` string, uri
        - `mime_type` string
        - `file_name` string
        - `size_bytes` integer
        - `width` integer
        - `height` integer
        - `duration_ms` integer
    - `pagination` Pagination, required
      - `limit` integer, required
      - `has_more` boolean, required
      - `next_cursor` string: Cursor for the next page. Omitted when there are no more results.

## Other responses

- `400`: Invalid request parameters.
- `401`: Missing, malformed, invalid, or retired local API key.
- `403`: 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.
- `429`: Rate limit exceeded. Public routes allow 50 requests per 10 seconds per IP and endpoint.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/talktohumans/apis/talktohumans-public-api.md) · [All operations](https://skmtc.dev/talktohumans/apis/talktohumans-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talktohumans/apis/talktohumans-public-api/revisions/4551ad2f26af?raw)