---
title: "Get Observability Iterations"
method: GET
path: "/agentic/observability/iterations"
tags: ["Agents Observability"]
---

# Get Observability Iterations

`GET /agentic/observability/iterations`

Per-iteration trace rollup, newest-first (reads ``agent_traces``).

One row per ``iteration_id`` — all operations of one input-record's
processing chain. ``agent_traces`` is Streamkap-agent only (no external
pseudo-agents), so ``agent_id`` passes straight through with no entity
resolution. Tenant scoping at the WHERE layer; a cross-tenant agent_id
returns an empty page, not a leak.

## Query parameters

- `agent_id` string, nullable — Streamkap agent id (Mongo ObjectId)
- `from` string, nullable — Time range start (ISO 8601)
- `to` string, nullable — Time range end (ISO 8601)
- `cursor` string, nullable — Pagination cursor — last page's next_cursor
- `limit` integer

## Response `200`

Successful Response

- ObservabilityIterationsResponse — `/agentic/observability/iterations` envelope. ``next_cursor`` is the ``started_at`` of the last row in the page, or ``None`` when fewer than ``limit`` rows came back (end of stream).
  - `items` ObservabilityIterationItem[], required
    - `iteration_id` string, required
    - `started_at` string, date-time, required
    - `ended_at` string, date-time, required
    - `op_count` integer, required
    - `error_count` integer, required
    - `duration_ms_total` integer, required
    - `agent_id` string, nullable
    - `agent_label` string, nullable
  - `next_cursor` string, date-time, nullable

## 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/revisions/e9ce8221bac6/schema)