GET /api/v1/usage
Paginated usage history: each row is one billed event (async settlement or synchronous endpoint charge). Read-only; scoped to the authenticated user.
| Attribute | Details |
|---|---|
| Auth | Required |
| Filters | None (no date or endpoint filter on this API) |
Query parameters
| Param | Default | Notes |
|---|---|---|
page | 1 | 1-based page index. |
limit | 50 | Page size, 1–200. Invalid → 400. |
sort | id | One of: id, created_at, eur_cents_charged, units. |
order | desc | asc or desc. |
Response shape
Returns usage_events (array) and pagination (echoes sort/order/limit plus total, total_pages).
Typical row fields: id, units, eur_cents_charged (EUR cents), created_at, optional async_job_id, optional endpoint (which API surface was billed).
Older rows may have endpoint / method as null — treat as unknown in UIs.