Listar as cobranças
Cada cobrança do espaço de trabalho, cada uma com a sua fatura.
Executa a chamada real no seu espaço de trabalho.
GET /billing/invoices
Cada cobrança do espaço de trabalho, cada uma com a sua fatura.
Exemplo
Requer billing:read. É o Histórico de Planos e faturação. page e limit percorrem as cobranças, sort é newest ou oldest, e search procura o plano, o número da fatura, o id da cobrança e o nome faturado.
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 significa que a fatura precisa primeiro de um nome e de uma morada de faturação, que PUT /billing/invoices/{orderId}/details guarda.
Só o proprietário do espaço de trabalho chega à faturação: uma chave de API, ou um token de acesso que o proprietário ligou com todos os endereços. O token de um membro dá um 403 owner_only, e uma chave ou um token limitado a certos endereços ou domínios dá um 422 capability_unsupported.