GET
Get EXTERNAL Conversation Messages

Overview

Get paginated message history for an EXTERNAL conversation. The caller must be a participant (same external_user_id or token identity). Preferred path: GET /api/v1/sdk/conversations/:conversationId/messages.
Legacy path: GET /api/v1/conversations/external/:conversationId/messages.
Auth: Either Bearer token (SDK token) or API keys (X-Api-Key + X-Api-Secret). With Bearer, external_user_id is derived from the token and can be omitted.

When to Use

  • Your frontend or backend needs to load past messages (inbox) for an EXTERNAL conversation.
  • Use with List EXTERNAL conversations to build a full inbox: list conversations, then fetch messages for the selected one.

Request Headers

*Use either Bearer token or API keys.

Path Parameters

Query Parameters

Example: Bearer token (SDK / frontend)

Example: API keys (backend)

With cursor (next page):

Response

Success (200)

  • Messages are ordered newest first (descending created_at). Use next_cursor as the cursor query param for the next page (older messages).
  • When has_next_page is false, there are no older messages.

Error Responses

SDK

The JavaScript SDK calls this endpoint when you use conversation.fetchMessages({ cursor, limit }). Configure apiUrl and Bearer token, API keys, or getRestHeaders(). See SDK Inbox.

List EXTERNAL conversations

Inbox list

Create EXTERNAL (API Key)

Create conversation