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
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.elizaos.ai/llms.txt

Use this file to discover all available pages before exploring further.

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