---
title: "List a session's events"
method: GET
path: "/phones/sessions/{session_id}/events"
tags: ["runs"]
---

# List a session's events

`GET /phones/sessions/{session_id}/events`

Returns the paginated event trace for a session (workflow runs and workflow-less interactive leases alike). Org-scoped: another org's session reads as not found. A trace past the organization's telemetry retention window returns an empty list with retention_expired=true; when the retention policy itself cannot be resolved the request fails with a 500 rather than serving events whose retention state is unknown.

## Path parameters

- `session_id` string, required — Session whose events to return.

## Query parameters

- `event_types` string[], nullable — Restrict results to specific event type codes (RUN_STARTED / OUTPUT_LOG / SDK_CALL_COMPLETED / etc.).
- `limit` integer — Maximum number of events to return (1-1000).
- `offset` integer — Pagination offset.

## Response `200`

OK

- RunEventsResponse — Paginated list of run events.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `events` RunEventSummary[], nullable, required — Page of run event records.
    - `body` unknown
    - `session_id` string, required — Session the event belongs to.
    - `timestamp` string, date-time, required — When the event occurred.
    - `type` string, required — Event type (e.g. RUN_STARTED, OUTPUT_LOG).
  - `inference_costs` object, required — Billed microdollars per inference_id.
  - `limit` integer, required — Page size used for this response.
  - `offset` integer, required — Pagination offset used for this response.
  - `retention_expired` boolean, required — True when the trace is past the org's retention window. Events are withheld from this point on, and the underlying data is physically deleted by a daily sweep; deletion may lag this flag by up to a day, after which the data is unrecoverable.
  - `sdk_call_costs` object, required — Billed microdollars per SDK-call span_id.
  - `total` integer, required — Total number of events matching the query.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/axilioai/apis/axilio-api.md) · [All operations](https://skmtc.net/axilioai/apis/axilio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/axilioai/axilio-api/revisions/4a74befa0bde/schema)