API
List the charges
Every charge of the workspace, each with its invoice.
GET/billing/invoices
Runs the real call on your workspace.
GET /billing/invoices
Every charge of the workspace, each with its invoice.
Example
Needs billing:read. It is History on Billing. page and limit page through the charges, sort is newest or oldest, and search matches the plan, the invoice number, the charge id and the name billed.
curl "$OE/billing/invoices?limit=10" -H "$AUTH"{ "object": "list", "data": [ { "object": "invoice", "id": "8c51f0d2-3b7e-4a19-b6c4-0e9d2f7a1c38", "createdAt": "2026-10-01T09:00:12.000Z", "amountCents": 10000, "subtotalCents": 10000, "currency": "usd", "status": "paid", "paid": true, "reason": "subscription_cycle", "invoiceNumber": "ACME-0007", "invoiceReady": true, "needsBillingDetails": false, "billingName": "Acme Ltd", "product": "Business", "payAsYouGo": false, "discount": null } ], "total": 7, "page": 1, "limit": 10, "hasMore": false, "metered": true}needsBillingDetails means the invoice needs a billing name and address first, which PUT /billing/invoices/{orderId}/details saves.
Only the owner of the workspace reaches billing: an API key, or an access token the owner connected with every address. A member’s token is a 403 owner_only, and a key or token limited to particular addresses or domains is a 422 capability_unsupported.