# client.observations

> client.observations — the observations operations.

`client.observations` — the `observations` operations.

On `AsyncKindgi` every method is the same, awaited.

## `client.observations.list()`

```python signature
list(
    *,
    limit: int | None = None,
    cursor: str | None = None,
    status: Literal['succeeded', 'guardrail-violation', 'guardrail-warning', 'tool-error', 'model-error', 'budget-exceeded', 'aborted', 'other'] | None = None,
    agent_id: str | UUID | None = None,
    agent_version: str | None = None,
    supervisor_id: str | UUID | None = None,
    conversation_id: str | UUID | None = None,
    since: str | None = None,
    until: str | None = None,
    timeout: float | None = None,
) -> ObservationCollectionPage
```

Query supervisor observations. `GET /v1/observations`

Cursor-paginated. Any authenticated caller can read observations for their tenant.