Перейти к документации
API

Показать платежи

Каждый платёж рабочего пространства, каждый со своим счётом.

GET/billing/invoices

Выполняет настоящий запрос в вашем рабочем пространстве.

GET /billing/invoices

Каждый платёж рабочего пространства, каждый со своим счётом.

Пример

Требуется billing:read. Это История в разделе «Тарифы и оплата». page и limit листают платежи, sort принимает newest или oldest, а search ищет по тарифу, номеру счёта, id платежа и имени в счёте.

curl
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 означает, что счёту сначала нужны имя и адрес для счёта, которые сохраняет PUT /billing/invoices/{orderId}/details.

К оплате есть доступ только у владельца рабочего пространства: это API-ключ или токен доступа, который владелец подключил со всеми адресами. Токен участника даёт 403 owner_only, а ключ или токен, ограниченный отдельными адресами или доменами, даёт 422 capability_unsupported.

Справочник