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

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

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

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"