List the billing provider orders
GET/api/v1/credits/orders
Return the billing provider-backed billing history for the caller's organization.
Orders are fetched live from the billing provider and filtered by the organization identifier stored in each order's metadata.
An empty list means this deployment sells nothing (no the billing provider access token) or the organization has bought nothing. It never means the billing provider was unreachable: a transient upstream fault answers 503 and a permanent one 502, because "you have no orders" is a statement about the customer's money and must not be synthesized from a failed call.
- Scope required:
billing:read. - Built-in role required: owner/admin.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 422
- 429
- 500
Successful Response
Bad request — malformed input or failed validation.
Missing, expired, or invalid credentials.
Authenticated but not authorized for this resource. Note: cross-organization reads return 404, not 403.
Resource not found, or hidden for tenant-enumeration safety (the caller lacks permission to know whether the resource exists).
Conflict — the current resource state does not allow this operation (e.g. assessment already started, email already in use).
Semantic validation failure — request shape was valid but contents were not.
Too many requests — rate limited. Retry after the window resets.
Internal server error — unexpected failure.