List Events

GET/v1/sessions/{session_id}/events

List the event history of a session.

Path parameters

stringsession_idrequired

The session ID (sess...)

Event object

Optional<string>id

Event ID (sevt...)

Optional<string>type

Event type (see below)

Optional<object[]>content

Typed content blocks carried by the event.

Optional<object | null>stop_reason

Reason execution stopped, when present.

Optional<string | null>model_used

Model used to produce the event, when applicable.

Optional<integer>tokens_in

Input tokens for this event (0 when N/A)

Optional<integer>tokens_out

Output tokens for this event (0 when N/A)

Optional<integer | null>duration_ms

Processing duration in milliseconds, when measured.

Optional<string | null>processed_at

RFC 3339 processing timestamp, when available.

Optional<string>created_at

RFC 3339 timestamp

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-sb-YOUR_KEY",
    base_url="https://api.sandbase.ai"
)

page = client.beta.sessions.events.list(session_id="sess_01abc...")
for event in page.data:
    print(f"{event.type}: {event.id}")

Response200 OK

{
  "data": [
    {
      "id": "sevt_01abc...",
      "type": "user.message",
      "content": [{ "type": "text", "text": "Where is my order #1234?" }],
      "stop_reason": null,
      "model_used": null,
      "tokens_in": 0,
      "tokens_out": 0,
      "duration_ms": null,
      "processed_at": "2026-05-29T10:00:00Z",
      "created_at": "2026-05-29T10:00:00Z"
    },
    {
      "id": "sevt_02def...",
      "type": "agent.message",
      "content": [{ "type": "text", "text": "Let me look up order #1234 for you." }],
      "stop_reason": null,
      "model_used": "claude-sonnet-4",
      "tokens_in": 1200,
      "tokens_out": 80,
      "duration_ms": 1840,
      "processed_at": "2026-05-29T10:00:02Z",
      "created_at": "2026-05-29T10:00:02Z"
    }
  ]
}