Skip to main content
GET
/
api
/
v1
/
usage
Get usage
curl --request GET \
  --url https://api.myrouter.example/api/v1/usage \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "period_start": "2023-11-07T05:31:56Z",
      "period_end": "2023-11-07T05:31:56Z",
      "request_count": 1,
      "model": "<string>",
      "api_key_hash": "<string>",
      "input_tokens": 1,
      "output_tokens": 1,
      "total_tokens": 1,
      "cache_read_tokens": 1,
      "cache_write_tokens": 1,
      "reasoning_tokens": 1
    }
  ],
  "request_id": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-request-id
string

Optional caller request id.

Query Parameters

start_time
string<date-time>
required

Usage start.

end_time
string<date-time>
required

Usage end.

granularity
enum<string>

Usage granularity.

Available options:
5m,
hour,
day
api_key_hash
string

Optional public key filter.

model
string

Optional model filter.

Response

Get usage response.

data
object[]
required

Usage buckets.

request_id
string

Request id.