Skip to main content
GET
/
threads
/
{threadId}
/
messages
List messages
curl --request GET \
  --url https://inboxapp.com/api/v1/threads/{threadId}/messages \
  --header 'Authorization: Bearer <token>'
{
  "teamId": "<string>",
  "threadId": "<string>",
  "messages": [
    {
      "platform": "twitter",
      "teamId": "<string>",
      "threadId": "<string>",
      "id": "<string>",
      "userId": "df6jbw4h36...",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "platformId": "1234567890",
      "content": "<string>",
      "campaignId": "df6jbw4h36...",
      "authorId": "<string>",
      "origin": "internal",
      "replyData": "<unknown>",
      "forwardData": "<unknown>",
      "entities": "<unknown>",
      "attachment": "<unknown>",
      "reactions": [
        "<unknown>"
      ],
      "isEncrypted": true,
      "isEdited": true,
      "failed": true,
      "deletedAt": "2023-11-07T05:31:56Z",
      "platformDeletedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "nextCursor": {
    "timestamp": "2023-11-07T05:31:56Z",
    "id": "<string>"
  },
  "isSyncing": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
threadId
string
required

The ID of the thread to list messages from.

Pattern: ^[0-9a-z]+$

Query Parameters

​
cursorId
string

The ID of the message to start pagination from. Must be used together with cursorTimestamp. Cannot be combined with the cursor object parameter.

Pattern: ^[0-9a-z]+$
​
cursorTimestamp
string<date-time>

The timestamp of the message to start pagination from. Must be used together with cursorId. Cannot be combined with the cursor object parameter.

Example:

"2025-11-10T18:03:16.000Z"

​
cursor
object

Pagination cursor using bracket notation. Omit to start from the beginning. Prefer using cursorId and cursorTimestamp instead for simpler query string encoding.

​
limit
integer
default:50

Maximum number of messages to return per page. Defaults to 50, maximum 100.

Required range: 1 <= x <= 100
Example:

50

Response

200 - application/json

OK

​
teamId
string
required
Pattern: ^[0-9a-z]+$
​
threadId
string
required
Pattern: ^[0-9a-z]+$
​
messages
object[]
required
​
nextCursor
object
required
​
isSyncing
boolean
required

Whether the thread is currently syncing older messages from the platform. If true, additional messages may become available shortly. Poll the endpoint to retrieve newly synced messages.