Sign in

v1

latestOpenAPI 3.1.02026-07-223261135.0 KB
usage

Get Api Usage

Summary + daily / per-key / per-operation aggregates for the caller's team.

Role-scoped: admins/owners see every row in the team; members see only rows attributable to their own API keys plus their own MCP-origin rows. Max range 90 days; defaults to the last 7 days when unspecified.

get/usage

Query parameters

api_key_idstring nullable

Optional API-key UUID filter. Narrows all aggregates to the given key.

Optional API-key UUID filter. Narrows all aggregates to the given key.

fromstring date-time nullable

ISO8601 UTC lower bound (inclusive). Defaults to to - 7d.

ISO8601 UTC lower bound (inclusive). Defaults to to - 7d.

tostring date-time nullable

ISO8601 UTC upper bound (exclusive). Defaults to now.

ISO8601 UTC upper bound (exclusive). Defaults to now.

Headers

Moda-Version'2026-04-12' | '2026-05-01'
Example:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Response

Successful Response