Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

A scoped AgentEye API key. Mint one in the dashboard under Settings → API keys, or with POST /v1/keys. Each endpoint names the permission it requires; a key without it gets 403 and a required_permission field naming what was missing.

Query Parameters

session_id
string

Exact session id.

agent_id
string

Exact agent id.

environment
string

Comma-separated environments.

status
string

One of done, error, timeout. Anything else is a 400.

ts_from
string

RFC 3339 lower bound on completed_at (inclusive).

ts_to
string

RFC 3339 upper bound on completed_at (inclusive).

cursor
integer<int64>

Opaque cursor from the previous page.

limit
integer<int64>

Default 50, capped at 200 — asking for more silently gets you 200.

score_filters
string

Comma-separated key:min..max ranges over the top-level numeric scores keys. Either bound may be omitted: factuality:0.9.., cost:..0.3. At most 20 entries; more is a 400. Entries that do not parse are dropped silently.

metric_filters
string

Same grammar and 20-entry cap as score_filters, but matched against the nested magnitude metrics at scores.metrics.<key> (cost, latency, tokens).

latest_per_session
boolean

Return only the most recent evaluation per session. Default false.

Response

A page of evaluations plus next_cursor.