---
title: "List run events"
method: POST
path: "/runs/events"
tags: ["runs"]
---

# List run events

`POST /runs/events`

Returns paginated run events for a session, filtered by session_id.

## Request body

- RunEventsRequest — Query parameters for fetching run events.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `event_types` string[], nullable — EventTypes restricts results to specific event type codes (RUN_STARTED / OUTPUT_LOG / SDK_CALL_COMPLETED / etc.).
  - `limit` integer, required — Maximum number of events to return.
  - `offset` integer, required — Pagination offset.
  - `session_id` string, required — Filters events to a specific device session (formerly allocation_id; W6-2).

## 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 plan's retention window; events are withheld.
  - `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/108ab4b41051/schema)