List usage records
GET/v1/usage
Returns metered usage records for a subscription item. Identify the item by subscription_item_id or by the product_slug + customer_id combination. Supports date-range filtering and limit/offset windowing.
Request​
Responses​
- 200
- 400
- 401
- 403
- 404
- 429
- 500
Usage records list with total_quantity aggregation in meta.
Request body failed validation.
Missing or invalid bearer token.
Token is valid but lacks permission for this operation. With code insufficient_scope, details.required carries the one minimal set of scopes that, added to details.granted, would let the request through: the resource scope (billing/{resource}, or billing/all off the catalogue) then the bare verb — e.g. ["billing/customers", "delete"].
Resource not found in the current organization.
Rate limit exceeded.
Unexpected server error.