Chat

Get Conversation History

Retrieve message history for a session.

GET/sessions/{session_id}/messages

Get conversation history for a session.

Path Parameters

Session identifier

Query Parameters

Max messages to return

Path Parameters

ParameterTypeRequiredDescription
session_idstringYesThe session ID from a chat response

Query Parameters

ParameterTypeDefaultDescription
limitinteger50Maximum 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

FieldTypeDescription
session_idstringSession identifier
messagesarrayChronologically ordered message list
messages[].rolestringuser or assistant
messages[].contentstringMessage text
messages[].timestampstringISO 8601 timestamp
messages[].usageobjectToken usage (assistant messages only)

Errors

CodeDescription
401Missing or invalid authentication
404Session not found

On this page