LeadReach AI - GET List messages in a thread Docs

GET/v1/agents/:id/threads/:threadId/messages

List messages in a thread

Uses cursor pagination (not page numbers). Pass the next cursor from the previous response.

Full URL

GET https://api.tryleadreach.com/v1/agents/:id/threads/:threadId/messages

Headers

X-Api-Key (required): your API key from the app Keys tab.

Path params (in the URL)

Name	Type	Required	Meaning
id	uuid	Yes	The agent's id (from Create agent or List agents).
threadId	uuid	Yes	The chat thread id (from Create thread or List threads).

Query params (after ?)

Name	Type	Required	Meaning
cursor	string	No	Opaque cursor from the previous page.
limit	number	No	Max messages to return. Default: 50.

Request body (JSON)

None

Example request (JSON)

What you send: headers, and path / query / body when used.

{
  "headers": {
    "X-Api-Key": "lr_your_key_here"
  },
  "path": {
    "id": "a1111111-1111-1111-1111-111111111111",
    "threadId": "t1111111-1111-1111-1111-111111111111"
  },
  "query": {
    "limit": 50
  }
}

Example response (JSON)

Typical successful response shape.

{
  "messages": [
    {
      "id": "m1111111-1111-1111-1111-111111111111",
      "role": "user",
      "content": "Hello"
    }
  ],
  "nextCursor": null
}

Response

Messages page plus a next cursor when more exist.