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. If the billing provider is not configured or the upstream call fails, the endpoint returns an empty list rather than an error so the billing page stays available.
- 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.