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.
| Method | Path | Returns |
|---|---|---|
| GET | /usage/daily | Daily totals and routing summary |
| GET | /usage/requests | Per-request records |
| GET | /usage/keys | Totals 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.