Agent UUID or name — scopes the whole response to one agent.
model
string | null
Exact model id, matched against span model attributes.
provider
string | null
Provider name filter (e.g. "openai", "anthropic").
org_unit
string | null
Org-unit filter (Enterprise). Open-source servers accept it and ignore it.
view
string | null
"agent" | "workflow" — which attribution source powers the response's
attributions field (default "agent").
my_agent
boolean
When true, restricts results to agents owned by the caller.
Ignored when agent_id is also set (already scoped to one agent).
compare
string | null
previous adds the preceding window of the same length to the same
response, so a caller comparing two windows needs one request, not two.
Anything else is ignored.
group_by
string | null
agent (spend-timeseries only) adds a per-agent series for the top
spenders plus an other aggregate, replacing one filtered request per
driver. Any other value is a 400.
top
integer<int64> | null
How many agents get their own series under group_by=agent
(default 5, clamped 1-20). The rest fold into other.
user_id
string | null
One user's usage only (a user UUID). An admin may name anyone; anyone else only
themselves (403 otherwise).