List LLM usage for the current org (SPA-only)
Returns time-bucketed LLM call counts and input/output tokens broken down by model. The query window is [since, until); rollup selects hour or day bucket size. Org scope is taken from the authenticated principal — there is no org_id query parameter.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
ISO8601 start of the query window (inclusive).
"2026-05-01T00:00:00.000Z"
ISO8601 end of the query window (exclusive).
"2026-05-08T00:00:00.000Z"
Time bucket size for the response rows.
hour, day "hour"
Filter by one or more model names (repeat the query param).
["claude-sonnet-4.6"]Dimension to group usage rows by.
all, skill, agent, interface, model "skill"
Filter by one or more skill IDs (repeat the query param).
["skill_abc"]Filter by one or more agent IDs (repeat the query param).
["agent_abc"]Filter by one or more user IDs (repeat the query param).
["user_abc"]Filter by one or more interface names (repeat the query param).
["slack", "web"]Response
Clerk org id (org_xxx) the result is scoped to. Matches metering.usage_events.org_id. NOT the Postgres tenant UUID.
hour, day Dimension that was grouped by in this response.
all, skill, agent, interface, model