Skip to main content
GET
Get the FinOps dashboard

Authorizations

Authorization
string
header
required

Session JWT. After nasiko auth login, print it with jq -r '.clusters[.active].token' ~/.nasiko/config.json. API keys aren't supported.

Query Parameters

start_time
string | null

ISO-8601 window start (default: 30 days ago). Ignored when range is set.

end_time
string | null

ISO-8601 window end (default: now). Without it a past-month selection means "that month through today" rather than that month.

range
string | null

"24h" | "7d" | "30d" — quick-select range, overrides start_time.

agent_id
string | null

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).

Response

FinOps dashboard data

data
object
required
message
string
required
status_code
integer<int32>
required
Required range: x >= 0