Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

A logged-in user session bearer token (WorkOS AuthKit access token from signup/login).

Path Parameters

orgId
string<uuid>
required

UUID of the developer organization.

Query Parameters

days
integer
default:30

Number of past days to include in the usage rollup (default 30, max 365).

Required range: 1 <= x <= 365

Response

object[] | null

Array of hourly usage records grouped by key and endpoint. NOTE: an org with no traffic in the window returns JSON null (not []) — verified live against the sandbox. The array element shape is shown below.

id
string<uuid>

Unique identifier for this resource.

key_id
string<uuid>

Identifier of the API key these requests were made with.

org_id
string<uuid>

Identifier of the developer organization that owns the key.

hour
string<date-time>

Start of the UTC hour this rollup covers (RFC 3339).

endpoint
string

Route pattern the requests hit (e.g. /api/v1/children).

status_2xx
integer

Count of 2xx (success) responses in this hour.

status_4xx
integer

Count of 4xx (client-error) responses in this hour.

status_5xx
integer

Count of 5xx (server-error) responses in this hour.

total_requests
integer

Total requests in this hour across all status classes.