---
title: "Get Observability Iteration Detail"
method: GET
path: "/agentic/observability/iterations/{iteration_id}"
tags: ["Agents Observability"]
---

# Get Observability Iteration Detail

`GET /agentic/observability/iterations/{iteration_id}`

Ordered operations for one trace iteration (reads ``agent_traces``).

Ordered by ``timestamp`` then a chat → tool_call → output tiebreak
(``sequence_number`` is not yet emitted). Tenant scoping makes a
cross-tenant ``iteration_id`` return an empty list — same as "not found",
no existence leak.

## Path parameters

- `iteration_id` string, required

## Response `200`

Successful Response

- ObservabilityIterationDetailResponse — `/agentic/observability/iterations/{iteration_id}` envelope. Operations are returned in execution order (timestamp, then a chat -> tool_call -> output tiebreak). ``truncated`` is ``True`` when a defensive row cap was hit (runaway ReAct loop).
  - `iteration_id` string, required
  - `operations` ObservabilityOperation[], required
    - `span_id` string, required
    - `operation` string, required
    - `status` string, required
    - `duration_ms` integer, required
    - `timestamp` string, date-time, required
    - `provider` string, nullable
    - `model` string, nullable
    - `tool_name` string, nullable
    - `input_tokens` integer, nullable
    - `output_tokens` integer, nullable
  - `truncated` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/streamkap/apis/streamkap-rest-api.md) · [All operations](https://skmtc.net/streamkap/apis/streamkap-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streamkap/streamkap-rest-api/versions/8aea6143d003/schema)