--- title: List Events url: https://platform.claude.com/docs/en/api/php/beta/sessions/events/list --- # List Events `$client->beta->sessions->events->list(string sessionID, ?\Datetime createdAtGt, ?\Datetime createdAtGte, ?\Datetime createdAtLt, ?\Datetime createdAtLte, ?int limit, ?Order order, ?string page, ?list types, ?list betas, ?string workspaceID): PageCursor` **GET** `/v1/sessions/{session_id}/events` List Events ## Parameters - `sessionID: string` (path parameter) - `createdAtGt?: optional \Datetime` (query parameter) Return events created after this time (exclusive). Compared against the event's `processed_at` value. - `createdAtGte?: optional \Datetime` (query parameter) Return events created at or after this time (inclusive). Compared against the event's `processed_at` value. - `createdAtLt?: optional \Datetime` (query parameter) Return events created before this time (exclusive). Compared against the event's `processed_at` value. - `createdAtLte?: optional \Datetime` (query parameter) Return events created at or before this time (inclusive). Compared against the event's `processed_at` value. - `limit?: optional int` (query parameter) - `order?: optional Order` (query parameter) Sort direction for results, ordered by the event's `processed_at`. Defaults to `asc` (chronological). - `page?: optional string` (query parameter) Opaque pagination cursor from a previous response's `next_page`. - `types?: optional list` (query parameter) 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. - `betas?: optional list` (header parameter) This endpoint is in beta: requests must send `managed-agents-2026-04-01` in this header. - `workspaceID?: optional string` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ## Returns - `class ManagedAgentsSessionEvent` - `class ManagedAgentsUserMessageEvent` - `"user.message" type` - `string id` Unique identifier for this event. - `list content` Array of content blocks comprising the user message. - `?\Datetime processedAt` Timestamp when the agent finished processing this message. - `class ManagedAgentsUserInterruptEvent` - `"user.interrupt" type` - `string id` Unique identifier for this event. - `?\Datetime processedAt` Timestamp when the interrupt was processed. - `?string sessionThreadID` If absent, interrupts every non-archived thread in a multiagent session (or the primary alone in a single-agent session). If present, interrupts only the named thread. - `class ManagedAgentsUserToolConfirmationEvent` - `"user.tool_confirmation" type` - `string id` Unique identifier for this event. - `Result result` The confirmation result: 'allow' or 'deny'. - `string toolUseID` The id of the `agent.tool_use` or `agent.mcp_tool_use` event this result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list?sdk_languages=php#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field. - `?string denyMessage` Optional message providing context for a 'deny' decision. Only allowed when result is 'deny'. - `?\Datetime processedAt` Timestamp when the confirmation was processed. - `?string sessionThreadID` Set by the server to the subagent thread this confirmation was routed to. Omitted when it was routed to the primary thread. - `class ManagedAgentsUserCustomToolResultEvent` - `"user.custom_tool_result" type` - `string id` Unique identifier for this event. - `string customToolUseID` The id of the `agent.custom_tool_use` event this result corresponds to. It is also listed in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list?sdk_languages=php#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field. - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `?\Datetime processedAt` Timestamp when this result was processed. - `?string sessionThreadID` Set by the server to the subagent thread this result was routed to. Omitted when it was routed to the primary thread. - `class ManagedAgentsAgentCustomToolUseEvent` - `"agent.custom_tool_use" type` - `string id` Unique identifier for this event. - `array input` Input parameters for the tool call. - `string name` Name of the custom tool being called. - `\Datetime processedAt` Timestamp when this tool use was processed. - `?string sessionThreadID` When set, this event was cross-posted from a subagent's thread to surface its custom tool use on the primary thread's stream. Empty on the thread's own events. Informational only: the server routes the matching `user.custom_tool_result` by `custom_tool_use_id`, so clients do not send it back. - `class ManagedAgentsAgentMessageEvent` - `"agent.message" type` - `string id` Unique identifier for this event. - `list content` Array of text blocks comprising the agent response. - `\Datetime processedAt` Timestamp when this response was generated. - `class ManagedAgentsAgentThinkingEvent` - `"agent.thinking" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp when this thinking was produced. - `class ManagedAgentsAgentMCPToolUseEvent` - `"agent.mcp_tool_use" type` - `string id` Unique identifier for this event. - `array input` Input parameters for the tool call. - `string mcpServerName` Name of the MCP server providing the tool. - `string name` Name of the MCP tool being used. - `\Datetime processedAt` Timestamp when this event was processed. - `?ManagedAgentsAgentEvaluatedPermission evaluatedPermission` The evaluated permission policy for this tool invocation. - `?ManagedAgentsAgentToolEvaluation evaluation` Which resolved permission_policy produced evaluated_permission: always_allow, always_ask, or auto (with the server's per-invocation judgement). Absent only when the server refused the call before any policy applied (for example, the named tool is not enabled in the session); such a refusal has evaluated_permission deny. An event recorded before this field existed reads as the arm its evaluated_permission implies (always_allow for allow, always_ask for ask). - `?string sessionThreadID` When set, this event was cross-posted from a subagent's thread to surface its permission request on the primary thread's stream. Empty on the thread's own events. Informational only: the server routes the matching `user.tool_confirmation` by `tool_use_id`, so clients do not send it back. - `class ManagedAgentsAgentMCPToolResultEvent` - `"agent.mcp_tool_result" type` - `string id` Unique identifier for this event. - `string mcpToolUseID` The id of the `agent.mcp_tool_use` event this result corresponds to. - `\Datetime processedAt` Timestamp when this event was processed. - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `class ManagedAgentsAgentToolUseEvent` - `"agent.tool_use" type` - `string id` Unique identifier for this event. - `array input` Input parameters for the tool call. - `string name` Name of the agent tool being used. - `\Datetime processedAt` Timestamp when this event was processed. - `?ManagedAgentsAgentEvaluatedPermission evaluatedPermission` The evaluated permission policy for this tool invocation. - `?ManagedAgentsAgentToolEvaluation evaluation` Which resolved permission_policy produced evaluated_permission: always_allow, always_ask, or auto (with the server's per-invocation judgement). Absent only when the server refused the call before any policy applied (for example, the named tool is not enabled in the session); such a refusal has evaluated_permission deny. An event recorded before this field existed reads as the arm its evaluated_permission implies (always_allow for allow, always_ask for ask). - `?string sessionThreadID` When set, this event was cross-posted from a subagent's thread to surface its permission request on the primary thread's stream. Empty on the thread's own events. Informational only: the server routes the matching `user.tool_confirmation` or `user.tool_result` by `tool_use_id`, so clients do not send it back. - `class ManagedAgentsAgentToolResultEvent` - `"agent.tool_result" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp when this event was processed. - `string toolUseID` The id of the `agent.tool_use` event this result corresponds to. - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `class ManagedAgentsAgentThreadMessageReceivedEvent` - `"agent.thread_message_received" type` - `string id` Unique identifier for this event. - `list content` Message content blocks. - `string fromSessionThreadID` Public `sthr_` ID of the thread that sent the message. - `\Datetime processedAt` Timestamp when the message was received. - `?string fromAgentName` Name of the callable agent this message came from. Absent when received from the primary agent. - `class ManagedAgentsAgentThreadMessageSentEvent` - `"agent.thread_message_sent" type` - `string id` Unique identifier for this event. - `list content` Message content blocks. - `\Datetime processedAt` Timestamp when the message was sent. - `string toSessionThreadID` Public `sthr_` ID of the thread the message was sent to. - `?string toAgentName` Name of the callable agent this message was sent to. Absent when sent to the primary agent. - `class ManagedAgentsAgentThreadContextCompactedEvent` - `"agent.thread_context_compacted" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp when compaction was processed. - `class ManagedAgentsSessionErrorEvent` - `"session.error" type` - `string id` Unique identifier for this event. - `Error error` - `\Datetime processedAt` Timestamp when the error occurred. - `class ManagedAgentsSessionStatusRescheduledEvent` - `"session.status_rescheduled" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp of status change. - `class ManagedAgentsSessionStatusRunningEvent` - `"session.status_running" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp of status change. - `class ManagedAgentsSessionStatusIdleEvent` - `"session.status_idle" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp of status change. - `?ManagedAgentsSessionRefusalStopDetails stopDetails` Structured information about why the session stopped. `null` when there is nothing more to report. - `StopReason stopReason` - `class ManagedAgentsSessionStatusTerminatedEvent` - `"session.status_terminated" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp of status change. - `class ManagedAgentsSessionThreadCreatedEvent` - `"session.thread_created" type` - `string id` Unique identifier for this event. - `string agentName` Name of the callable agent the thread runs. - `\Datetime processedAt` Timestamp when the thread was created. - `string sessionThreadID` Public `sthr_` ID of the newly created thread. - `?string workflowRunID` Identifier of the workflow run that created the thread, or `null` for any other thread. - `class ManagedAgentsSpanOutcomeEvaluationStartEvent` - `"span.outcome_evaluation_start" type` - `string id` Unique identifier for this event. - `int iteration` 0-indexed revision cycle. 0 is the first evaluation; 1 is the re-evaluation after the first revision; etc. - `string outcomeID` The `outc_` ID of the outcome being evaluated. - `\Datetime processedAt` Timestamp when outcome evaluation started. - `class ManagedAgentsSpanOutcomeEvaluationEndEvent` - `"span.outcome_evaluation_end" type` - `string id` Unique identifier for this event. - `string explanation` Human-readable explanation of the verdict. For `needs_revision`, describes which criteria failed and why. - `int iteration` 0-indexed revision cycle, matching the corresponding `span.outcome_evaluation_start`. - `string outcomeEvaluationStartID` The id of the corresponding `span.outcome_evaluation_start` event. - `string outcomeID` The `outc_` ID of the outcome being evaluated. - `\Datetime processedAt` Timestamp when outcome evaluation ended. - `string result` Evaluation verdict. 'satisfied': criteria met, session goes idle. 'needs_revision': criteria not met, another revision cycle follows. 'max_iterations_reached': evaluation budget exhausted with criteria still unmet — one final acknowledgment turn follows before the session goes idle, but no further evaluation runs. 'failed': grader determined the rubric does not apply to the deliverables. 'interrupted': user sent an interrupt while evaluation was in progress. - `ManagedAgentsSpanModelUsage usage` Aggregate token usage for this evaluation cycle. Sums across all grader model requests within the cycle. - `class ManagedAgentsSpanModelRequestStartEvent` - `"span.model_request_start" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp when the model request started. - `class ManagedAgentsSpanModelRequestEndEvent` - `"span.model_request_end" type` - `string id` Unique identifier for this event. - `?bool isError` Whether the model request resulted in an error. - `string modelRequestStartID` The id of the corresponding `span.model_request_start` event. - `ManagedAgentsSpanModelUsage modelUsage` Token usage for this model request. - `\Datetime processedAt` Timestamp when the model request completed. - `class ManagedAgentsSpanOutcomeEvaluationOngoingEvent` - `"span.outcome_evaluation_ongoing" type` - `string id` Unique identifier for this event. - `int iteration` 0-indexed revision cycle, matching the corresponding `span.outcome_evaluation_start`. - `string outcomeID` The `outc_` ID of the outcome being evaluated. - `\Datetime processedAt` Timestamp when this heartbeat was emitted. - `class ManagedAgentsUserDefineOutcomeEvent` - `"user.define_outcome" type` - `string id` Unique identifier for this event. - `string description` What the agent should produce. Copied from the input event. - `?int maxIterations` Evaluate-then-revise cycles before giving up. Default 3, max 20. - `string outcomeID` Server-generated `outc_` ID for this outcome. Referenced by `span.outcome_evaluation_*` events and the session's `outcome_evaluations` list. - `\Datetime processedAt` Timestamp when the outcome was accepted. - `Rubric rubric` How to grade the outcome. File rubrics are currently resolved to their text content; clients should handle both variants. - `class ManagedAgentsSessionDeletedEvent` - `"session.deleted" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp when the session was deleted. - `class ManagedAgentsSessionThreadStatusRunningEvent` - `"session.thread_status_running" type` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` Timestamp of the status transition. - `string sessionThreadID` Public sthr_ ID of the thread that started running. - `class ManagedAgentsSessionThreadStatusIdleEvent` - `"session.thread_status_idle" type` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` Timestamp of the status transition. - `string sessionThreadID` Public sthr_ ID of the thread that went idle. - `?ManagedAgentsSessionRefusalStopDetails stopDetails` Structured information about why the thread stopped. `null` when there is nothing more to report. - `StopReason stopReason` - `class ManagedAgentsSessionThreadStatusTerminatedEvent` - `"session.thread_status_terminated" type` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` Timestamp of the status transition. - `string sessionThreadID` Public sthr_ ID of the thread that terminated. - `class BetaManagedAgentsUserToolResultEvent` - `"user.tool_result" type` - `string id` Unique identifier for this event. - `string toolUseID` The id of the `agent.tool_use` event this result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list?sdk_languages=php#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field. - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `?\Datetime processedAt` Timestamp when this result was processed. - `?string sessionThreadID` Set by the server to the subagent thread this result was routed to. Omitted when it was routed to the primary thread. - `class ManagedAgentsSessionThreadStatusRescheduledEvent` - `"session.thread_status_rescheduled" type` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` Timestamp of the status transition. - `string sessionThreadID` Public sthr_ ID of the thread that is retrying. - `class BetaManagedAgentsSessionUpdatedEvent` - `"session.updated" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp when the update was applied. - `?BetaManagedAgentsSessionAgent agent` The session's effective agent configuration after the update. Present only when the update changed `agent` (tools or mcp_servers); when present it is the full materialised snapshot, not a diff. - `?BetaManagedAgentsBudgetLimit budget` The session's budget after the update: the new budget when set or replaced, or null when the update removed it. Present only when the update changed the budget. - `?array metadata` The session's full metadata bag after the update. Present when the update set non-empty metadata; absent when metadata was unchanged or cleared to empty. - `?string title` The session's new title. Present only when the update changed it. - `class BetaManagedAgentsSystemMessageEvent` - `"system.message" type` - `string id` Unique identifier for this event. - `list content` System content blocks. Text-only. - `?\Datetime processedAt` Timestamp when this system message was processed. - `class BetaManagedAgentsSessionUsageEvent` - `"session.usage" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp when the snapshot was taken. - `ManagedAgentsSessionUsageSnapshot usage` The session's cumulative usage at the snapshot time. - `?BetaManagedAgentsBudgetLimit budget` The session's configured budget at the snapshot time, or null when the session has no budget. - `class ManagedAgentsWorkflowRunCreatedEvent` - `"workflow_run.created" type` - `string id` Unique identifier for this event. - `?string description` Description that the agent gave the run, passed on as written, or `null` if it gave none. - `string name` Name that the agent gave the run, passed on as written, or a name that the server assigned. - `list phases` The phases that the run's plan declares, in the plan's order. Can be empty. - `\Datetime processedAt` Timestamp when this event was processed. - `string workflowRunID` Identifier of the run. The same value is on all of the run's `workflow_run.*` events. - `class ManagedAgentsWorkflowRunStatusEndedEvent` - `"workflow_run.status_ended" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp when this event was processed. - `ManagedAgentsWorkflowRunResult result` How the run ended. - `string workflowRunID` Identifier of the run. The same value is on all of the run's `workflow_run.*` events. - `class ManagedAgentsWorkflowRunPhaseStartedEvent` - `"workflow_run.phase_started" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp when this event was processed. - `string workflowRunID` Identifier of the run. The same value is on all of the run's `workflow_run.*` events. - `string workflowRunPhaseID` Identifier of the phase, as in `phases` on the run's `workflow_run.created` event. - `class ManagedAgentsWorkflowRunPhaseEndedEvent` - `"workflow_run.phase_ended" type` - `string id` Unique identifier for this event. - `string phaseStartedID` Identifier of the `workflow_run.phase_started` event that opened the phase. - `\Datetime processedAt` Timestamp when this event was processed. - `string workflowRunID` Identifier of the run. The same value is on all of the run's `workflow_run.*` events. - `string workflowRunPhaseID` Identifier of the phase, as in `phases` on the run's `workflow_run.created` event. - `class ManagedAgentsWorkflowRunStatusRunningEvent` - `"workflow_run.status_running" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp when this event was processed. - `string workflowRunID` Identifier of the run. The same value is on all of the run's `workflow_run.*` events. - `class ManagedAgentsWorkflowRunStatusIdleEvent` - `"workflow_run.status_idle" type` - `string id` Unique identifier for this event. - `\Datetime processedAt` Timestamp when this event was processed. - `string workflowRunID` Identifier of the run. The same value is on all of the run's `workflow_run.*` events. - `class ManagedAgentsWorkflowRunErrorEvent` - `"workflow_run.error" type` - `string id` Unique identifier for this event. - `ManagedAgentsWorkflowRunError error` Why the run did not finish, or was not created. - `\Datetime processedAt` Timestamp when this event was processed. - `?string workflowRunID` Identifier of the run that met the error, or `null` when the error kept a run from being created. ## Example ```php beta->sessions->events->list( 'sesn_011CZkZAtmR3yMPDzynEDxu7', createdAtGt: new \DateTimeImmutable('2019-12-27T18:11:19.117Z'), createdAtGte: new \DateTimeImmutable('2019-12-27T18:11:19.117Z'), createdAtLt: new \DateTimeImmutable('2019-12-27T18:11:19.117Z'), createdAtLte: new \DateTimeImmutable('2019-12-27T18:11:19.117Z'), limit: 0, order: 'asc', page: 'page', types: [ManagedAgentsSessionEventType::USER_MESSAGE], betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24], workspaceID: 'wrkspc_011CZkZaBF1tNoB5wlCeusgy', ); var_dump($page); ``` ### Response (200) ```json { "data": [ { "id": "sevt_011CZkZGPp1iBcp4kaQSihUm", "content": [ { "text": "Where is my order #1234?", "type": "text" } ], "type": "user.message", "processed_at": "2026-03-15T10:00:00Z" }, { "id": "sevt_011CZkZHPq1jCdq5mbRTjiVn", "content": [ { "text": "Let me look up order #1234 for you.", "type": "text" } ], "processed_at": "2026-03-15T10:00:00Z", "type": "agent.message" } ], "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo=" } ```