GET
GET /v1/sessions/{session_id}/events?beta=true — Claude API
Beta
Anthropic API key (required); https://api.anthropic.com
Claude APIList Events
- Base URL
- https://api.anthropic.com
- Auth
- x-api-key: <ANTHROPIC_API_KEY>
- Last verified
- 2026-10-20 · upstream hash matched
Actions Try in browser→
Agents: curl -H "Accept: text/markdown" this URL
→ 349 tokens · Vary: Accept
→ 349 tokens · Vary: Accept
Critical gotchas
Authentication uses the x-api-key header and requests also require an anthropic-version header.
The official OpenAPI URL is discovered from the SDK repository manifest and must remain under Anthropic's trusted Stainless storage prefix.
cURL
curl -X GET 'https://api.anthropic.com/v1/sessions/session-id/events?beta=true&limit=10&page=example-page&order=asc&types%5B%5D=example&created_at%5Bgte%5D=example-created-at%5Bgte%5D&created_at%5Bgt%5D=example-created-at%5Bgt%5D&created_at%5Blte%5D=example-created-at%5Blte%5D&created_at%5Blt%5D=example-created-at%5Blt%5D' \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H 'anthropic-version: 2023-06-01'
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| session_id | path | string | Yes | Path parameter session_id |
| limit | query | integer | No | Query parameter for limit |
| page | query | string | No | Opaque pagination cursor from a previous response's `next_page`. |
| order | query | string | No | Sort direction for results, ordered by the event's `processed_at`. Defaults to `asc` (chronological). |
| types[] | query | string[] | No | 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] | query | string | No | Return events created at or after this time (inclusive). Compared against the event's `processed_at` value. |
| created_at[gt] | query | string | No | Return events created after this time (exclusive). Compared against the event's `processed_at` value. |
| created_at[lte] | query | string | No | Return events created at or before this time (inclusive). Compared against the event's `processed_at` value. |
| created_at[lt] | query | string | No | Return events created before this time (exclusive). Compared against the event's `processed_at` value. |
Response 200 OK
{
"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="
} Get a free Claude API key → sponsored Affiliate link - we may earn a commission, at no extra cost to you.