Skip to the documentation
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 Plans & 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
curl "$OE/billing/invoices?limit=10" -H "$AUTH"
Response
{  "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.

Reference