Skip to main content
GET
Get Usage

Authorizations

Authorization
string
header
required

A Kite API key (kite_...), from Platform API → Keys in the dashboard.

Headers

Kite-Version
enum<string>
default:2026-09-27

The dated contract your code was written against. Without it you get 2026-09-27; every response says which version served it.

Available options:
2026-09-27,
2026-10-12

Query Parameters

start
string<date> | null
end
string<date> | null
group_by
enum<string>
default:resource

Group each day's tokens by resource family, by the API key that started the runs, or by where they were started

Available options:
resource,
api_key,
source
api_key_id
string | null

Only the runs this API key started

source
enum<string> | null

Only the runs started from this surface: the API, CLI, MCP server, Python SDK or the console. unknown is the work whose surface was never recorded (before October 2026, and worlds and motions), so the sources add up to the whole account

Available options:
api,
cli,
mcp,
sdk,
dashboard,
unknown

Response

Token usage in the range

Tokens used per day, grouped by resource family, API key or source.

start
string
required

YYYY-MM-DD, inclusive

end
string
required

YYYY-MM-DD, inclusive

data
(UsageDay · object | UsageDayByKey · object | UsageDayBySource · object)[]
required

One row per day and group with any usage, oldest first. The group field is resource, api_key_id or source, as group_by asks

A day of usage for one resource family (group_by=resource, the default).

totals
UsageTotals · object
required
object
enum<string>
default:usage
Available options:
usage
Allowed value: "usage"