Skip to main content
GET
/
api
/
usage
/
timeseries
Get usage timeseries
curl --request GET \
  --url https://api.example.com/api/usage/timeseries \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "bucket": "<string>",
      "endpoint": "<string>",
      "request_count": 123,
      "error_count": 123
    }
  ]
}

Authorizations

Authorization
string
header
required

Auth0 JWT access token

Query Parameters

start_date
string<date>
required

Start date (inclusive), ISO 8601 date format

Example:

"2026-01-01"

end_date
string<date>
required

End date (inclusive), ISO 8601 date format

Example:

"2026-01-31"

client_id
string

Client ID to query (admin only — M2M tokens see own usage only)

granularity
enum<string>
default:daily

Time bucket granularity

Available options:
hourly,
daily
Example:

"daily"

Response

Usage timeseries

data
object[]
required