Skip to content
alpharouter

Docs

Usage API

Read billing and aggregates externally, for wiring into internal BI or a cost dashboard.

Read-only keys

Access requires a usage query key, not a service key. Up to three per organization, and an IP allowlist is mandatory.

Paths

Daily aggregates and per-request listings are served separately. Daily aggregates include a routing decision summary.

MethodPathReturns
GET/usage/dailyDaily totals and routing summary
GET/usage/requestsPer-request records
GET/usage/keysTotals grouped by key

Pagination

Cursor-based. An empty next_cursor means the end. Up to 1000 records per page.

Propagation delay

Aggregates lag by up to 5 minutes. For realtime cutoffs, use the key budget feature instead.