Skip to main content
GET
/
api
/
messaging
/
sessions
/
{sessionId}
/
messages
Get session messages
curl --request GET \
  --url http://localhost:3000/api/messaging/sessions/{sessionId}/messages
{
  "messages": [
    {
      "id": "<string>",
      "content": "<string>",
      "authorId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "isAgent": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "metadata": {}
    }
  ],
  "hasMore": true,
  "cursors": {
    "before": 123,
    "after": 123
  }
}
Messages are returned in reverse chronological order (newest first) by default. Use the cursor values for efficient pagination through large conversation histories.

​
Path Parameters

​
sessionId
string
required
The unique identifier of the session

​
Query Parameters

​
limit
number
Number of messages to retrieve (1-100). Default: 50
​
before
number
Timestamp to get messages before (for older messages)
​
after
number
Timestamp to get messages after (for newer messages)

​
Response

​
messages
array
Array of messages in the conversation
​
hasMore
boolean
Whether more messages are available
​
cursors
object
Pagination cursors for fetching additional messages

​
Example Usage

// Get the most recent 20 messages
const response = await fetch(
  '/api/messaging/sessions/abc-123/messages?limit=20'
);

const { messages, hasMore, cursors } = await response.json();

Path Parameters

​
sessionId
string
required

ID of the session

Query Parameters

​
limit
integer
default:50

Maximum number of messages to return

Required range: 1 <= x <= 100
​
before
string<date-time>

Get messages before this timestamp

​
after
string<date-time>

Get messages after this timestamp

Response

Messages retrieved successfully

​
messages
object[]
​
hasMore
boolean

Whether there are more messages available

​
cursors
object

Pagination cursors for fetching additional messages