v49

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-261319281.7 MB

List Events

get/v1/sessions/{session_id}/events?beta=true

Path parameters

session_idstring required

Path parameter session_id

Query parameters

limitinteger

Query parameter for limit

pagestring

Opaque pagination cursor from a previous response's next_page.

order'asc' | 'desc'

ListOrder enum

Sort direction for results, ordered by the event's processed_at. Defaults to asc (chronological).

types[]string[]

Filter by event type. Values match the type field on returned events (for example, user.message or agent.tool_use). Omit to return all event types.

created_at[gte]string date-time

A timestamp in RFC 3339 format

Return events created at or after this time (inclusive). Compared against the event's processed_at value.

created_at[gt]string date-time

A timestamp in RFC 3339 format

Return events created after this time (exclusive). Compared against the event's processed_at value.

created_at[lte]string date-time

A timestamp in RFC 3339 format

Return events created at or before this time (inclusive). Compared against the event's processed_at value.

created_at[lt]string date-time

A timestamp in RFC 3339 format

Return events created before this time (exclusive). Compared against the event's processed_at value.

Headers

x-api-keystring

anthropic-versionstring

anthropic-betastring

Response

Successful response (OK)

next_pagestring nullable

Opaque cursor for the next page. Null when no more results.

Example response

{
  "data": [
    {
      "type": "user.message",
      "id": "sevt_011CZkZGOp0iBcp4kaQSihUmy",
      "content": [
        {
          "type": "text",
          "text": "Where is my order #1234?"
        }
      ],
      "processed_at": "2026-03-15T10:00:00Z"
    },
    {
      "type": "agent.message",
      "id": "sevt_011CZkZHPq1jCdq5lbRTjiVnz",
      "content": [
        {
          "type": "text",
          "text": "Let me look up order #1234 for you."
        }
      ],
      "processed_at": "2026-03-15T10:00:00Z"
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}