Listar los cargos
Cada cargo del espacio de trabajo, cada uno con su factura.
Ejecuta la llamada real en tu espacio de trabajo.
GET /billing/invoices
Cada cargo del espacio de trabajo, cada uno con su factura.
Ejemplo
Requiere billing:read. Es el Historial de Planes y facturación. page y limit recorren los cargos, sort es newest u oldest, y search busca el plan, el número de factura, el id del cargo y el nombre facturado.
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 la factura necesita antes un nombre y una dirección de facturación, que guarda PUT /billing/invoices/{orderId}/details.
Solo el propietario del espacio de trabajo llega a la facturación: una clave de API, o un token de acceso que el propietario conectó con todas las direcciones. El token de un miembro es un 403 owner_only, y una clave o un token limitado a ciertas direcciones o dominios es un 422 capability_unsupported.