Skip to main content
GET
Get API usage for specified dates

Authorizations

x-api-key
string
header
required

Query Parameters

from
string<date>
required

Start date for the usage data (YYYY-MM-DD format)

to
string<date>
required

End date for the usage data (YYYY-MM-DD format)

Response

Success

Per-day, per-path usage map for the requested date range, plus an avgRequestsPerHour summary field. When the live AWS lookup is rate-limited the response is served from cache and additionally carries the stale and generated_at markers.

avgRequestsPerHour
string

Average requests per hour over the requested range.

Example:

"41.67"

stale
boolean

Present and true only when this response was served from the persisted cache because the live AWS usage lookup was rate-limited. Absent on live responses.

Example:

true

generated_at
string<date-time>

Last-write time of the persisted usage record (organization.updated_at) — the age of the stored record, not of the underlying measurement. Drives the X-Data-Age-Seconds header. Present only on the stale (cache-served) fallback path.

Example:

"2026-08-20T12:00:00.000Z"

{key}
object