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

# Get Observability Iterations Histogram

`GET /agentic/observability/iterations/histogram`

Operation-volume histogram over the trace stream. Default range 24h.

Status-stacked bucket shape matches the MCP histogram so the FE reuses one
renderer; ``agent_traces`` has no ``denied`` status (always 0).

## 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)
- `buckets` integer

## Response `200`

Successful Response

- ObservabilityHistogramResponse
  - `buckets` ObservabilityHistogramBucket[], required
    - `bucket_start` string, date-time, required
    - `success` integer, required
    - `error` integer, required
    - `denied` integer, required
  - `total` integer, required

## 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/8aea6143d003/schema)