Chat
Get Conversation History
Retrieve message history for a session.
GET
/sessions/{session_id}/messagesGet conversation history for a session.
Path Parameters
Session identifier
Query Parameters
Max messages to return
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
session_id | string | Yes | The session ID from a chat response |
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | integer | 50 | Maximum number of messages to return |
Response 200
{
"session_id": "sess_customer_001",
"messages": [
{
"role": "user",
"content": "What are your business hours?",
"timestamp": "2026-03-07T12:00:00Z"
},
{
"role": "assistant",
"content": "Our business hours are Monday through Friday, 9 AM to 6 PM EST.",
"timestamp": "2026-03-07T12:00:01Z",
"usage": {
"input_tokens": 45,
"output_tokens": 22
}
},
{
"role": "user",
"content": "Are you open on weekends?",
"timestamp": "2026-03-07T12:01:15Z"
},
{
"role": "assistant",
"content": "Yes, we're open on Saturdays from 10 AM to 2 PM. Closed on Sundays.",
"timestamp": "2026-03-07T12:01:16Z",
"usage": {
"input_tokens": 78,
"output_tokens": 20
}
}
]
}Response Fields
| Field | Type | Description |
|---|---|---|
session_id | string | Session identifier |
messages | array | Chronologically ordered message list |
messages[].role | string | user or assistant |
messages[].content | string | Message text |
messages[].timestamp | string | ISO 8601 timestamp |
messages[].usage | object | Token usage (assistant messages only) |
Errors
| Code | Description |
|---|---|
401 | Missing or invalid authentication |
404 | Session not found |