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="
}

Changes

Changed in 16 of the 68 revisions of this API.7477

Sep 1, 2026d1d189d791d12See the full diff
- ○
  added subschema #2 to the //////////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the /////////////////////////// response property anyOf list for the response status
  response-property-any-of-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 19, 20260042750ea1ee82See the full diff
- ▲
  added to the ///////////////////////////////// response property oneOf list for the response status
  response-property-one-of-added
- ▲
  added to the ////////////////// response property oneOf list for the response status
  response-property-one-of-added
- ▲
  removed the required property ////////////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /////////////////// from the response with the status
  response-required-property-removed
- ○
  added discriminator to ///////////////////////////////// response property for the response status
  response-property-discriminator-added
- ○
  added discriminator to ////////////////// response property for the response status
  response-property-discriminator-added
Aug 17, 2026d2b230555b7f3322See the full diff
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentCustomToolUseEvent]/session_thread_id list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentMcpToolResultEvent]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/context list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentMcpToolResultEvent]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/title list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentMcpToolResultEvent]/is_error list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentMcpToolUseEvent]/session_thread_id list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentThreadMessageReceivedEvent]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/context list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentThreadMessageReceivedEvent]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/title list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentThreadMessageReceivedEvent]/from_agent_name list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentThreadMessageSentEvent]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/context list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentThreadMessageSentEvent]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/title list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentThreadMessageSentEvent]/to_agent_name list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentToolResultEvent]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/context list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentToolResultEvent]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/title list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentToolResultEvent]/is_error list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsAgentToolUseEvent]/session_thread_id list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsSessionUpdatedEvent]/title list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsSpanModelRequestEndEvent]/is_error list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsUserCustomToolResultEvent]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/context list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsUserCustomToolResultEvent]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/title list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsUserCustomToolResultEvent]/is_error list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsUserCustomToolResultEvent]/session_thread_id list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsUserDefineOutcomeEvent]/max_iterations list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsUserInterruptEvent]/session_thread_id list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsUserMessageEvent]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/context list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsUserMessageEvent]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/title list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsUserToolConfirmationEvent]/deny_message list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsUserToolConfirmationEvent]/session_thread_id list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsUserToolResultEvent]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/context list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsUserToolResultEvent]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/title list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsUserToolResultEvent]/is_error list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsUserToolResultEvent]/session_thread_id list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property next_page list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  the ////// response property's maxLength was unset from 10000 for the response status
  response-property-max-length-unset
- ○
  removed from the ////// response property allOf list for the response status
  response-property-all-of-removed
- ○
  removed from the ////// response property allOf list for the response status
  response-property-all-of-removed
- ○
  removed from the ////// response property allOf list for the response status
  response-property-all-of-removed
- ○
  removed from the /////////// response property allOf list for the response status
  response-property-all-of-removed
- ○
  removed from the /////////// response property allOf list for the response status
  response-property-all-of-removed
- ○
  removed from the ////// response property allOf list for the response status
  response-property-all-of-removed
- ○
  removed from the ////// response property allOf list for the response status
  response-property-all-of-removed
- ○
  removed from the ////// response property allOf list for the response status
  response-property-all-of-removed
- ○
  removed from the ////// response property allOf list for the response status
  response-property-all-of-removed
- ○
  removed from the ////// response property allOf list for the response status
  response-property-all-of-removed
- ○
  removed from the ////// response property allOf list for the response status
  response-property-all-of-removed
- ○
  added subschema #2 to the ////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the ////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the ////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the /////////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the /////////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the ////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the ////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the ////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the ////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the ////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the ////// response property anyOf list for the response status
  response-property-any-of-added
Aug 6, 202693d8fd7d64932110See the full diff
- ▲
  added to the /////// response property oneOf list for the response status
  response-property-one-of-added
- ▲
  added to the /////// response property oneOf list for the response status
  response-property-one-of-added
- ▲
  added to the /////// response property oneOf list for the response status
  response-property-one-of-added
- ▲
  added to the ////// response property oneOf list for the response status
  response-property-one-of-added
- ▲
  added to the ////// response property oneOf list for the response status
  response-property-one-of-added
- ▲
  added to the ///////////////////// response property oneOf list for the response status
  response-property-one-of-added
- ▲
  added to the / response property oneOf list for the response status
  response-property-one-of-added
- ▲
  added to the /////// response property oneOf list for the response status
  response-property-one-of-added
- ▲
  the ///////////////////// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  removed the required property //////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////// from the response with the status
  response-required-property-removed
- ○
  added the optional property //////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
- ○
  added discriminator to /////// response property for the response status
  response-property-discriminator-added
- ○
  added discriminator to ///////////////////// response property for the response status
  response-property-discriminator-added
- ○
  added budget_reached discriminator mapping keys to the ////// response property for the response status
  response-property-discriminator-mapping-added
- ○
  added budget_reached discriminator mapping keys to the ////// response property for the response status
  response-property-discriminator-mapping-added
- ○
  added redacted discriminator mapping keys to the /////// response property for the response status
  response-property-discriminator-mapping-added
- ○
  added redacted discriminator mapping keys to the /////// response property for the response status
  response-property-discriminator-mapping-added
- ○
  added redacted discriminator mapping keys to the /////// response property for the response status
  response-property-discriminator-mapping-added
- ○
  added session.usage discriminator mapping keys to the / response property for the response status
  response-property-discriminator-mapping-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 24, 2026a97790bd7f184See the full diff
- ○
  added subschema #4 subschema #5 subschema #6 subschema #7 subschema #11 subschema #12 to the //////////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #4 subschema #5 subschema #6 subschema #7 subschema #11 subschema #12 to the /////////////////////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed subschema #4 subschema #5 subschema #6 subschema #10 subschema #11 from the //////////// response property anyOf list for the response status
  response-property-any-of-removed
- ○
  removed subschema #4 subschema #5 subschema #6 subschema #10 subschema #11 from the /////////////////////// response property anyOf list for the response status
  response-property-any-of-removed
Jul 22, 20265e4a8830793b2See the full diff
- ○
  added the optional property //////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////////////////// to the response with the status
  response-optional-property-added
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 30, 20267caa9a75ddbc2See the full diff
- ○
  added subschema #2 to the //////////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the /////////////////////// response property anyOf list for the response status
  response-property-any-of-added
Jun 9, 20262336fecb081b22See the full diff
- ▲
  added to the ////// response property oneOf list for the response status
  response-property-one-of-added
- ▲
  added to the / response property oneOf list for the response status
  response-property-one-of-added
- ○
  added credential_host_unreachable_error discriminator mapping keys to the ////// response property for the response status
  response-property-discriminator-mapping-added
- ○
  added system.message discriminator mapping keys to the / response property for the response status
  response-property-discriminator-mapping-added
Jun 9, 202600259327305f2See the full diff
- ○
  added subschema #2 to the //////////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the /////////////////////// response property anyOf list for the response status
  response-property-any-of-added
Jun 6, 2026546c704d347b210See the full diff
- ▲
  response property data/items/oneOf[BetaManagedAgentsSessionUpdatedEvent]/agent/allOf[BetaManagedAgentsSessionAgent]/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/tools/items/oneOf[BetaManagedAgentsCustomTool]/input_schema/required list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/oneOf[BetaManagedAgentsSessionUpdatedEvent]/agent/allOf[BetaManagedAgentsSessionAgent]/tools/items/oneOf[BetaManagedAgentsCustomTool]/input_schema/required list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ○
  removed from the ///////////////////////////// response property allOf list for the response status
  response-property-all-of-removed
- ○
  removed from the ////////////////// response property allOf list for the response status
  response-property-all-of-removed
- ○
  added subschema #1 subschema #2 to the ///////////////////////////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #1 subschema #2 to the ////////////////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  the response property ///////////////////////////// became required for the status
  response-property-became-required
- ○
  the response property ////////////////// became required for the status
  response-property-became-required
- ○
  the response property const value object was added for the status
  response-property-const-added
- ○
  the response property const value object was added for the status
  response-property-const-added
- ○
  removed the object enum value from the ///////////////////////////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the object enum value from the ////////////////// response property for the response status
  response-property-enum-value-removed

Full history (16 revisions)