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

Прочитать тариф

Тариф рабочего пространства, что в него входит и сколько из этого использовано.

GET/billing

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

GET /billing

Тариф рабочего пространства, что в него входит и сколько из этого использовано.

Пример

Требуется billing:read. Это то, что показывает раздел «Тарифы и оплата»: как оплачивается тариф, когда он продлевается или заканчивается и следующий платёж, домены, отправки за этот месяц, ИИ-действия за сегодня и оплата по факту. limit со значением null означает, что у тарифа лимита нет.

curl
curl "$OE/billing" -H "$AUTH"
Ответ
{  "object": "billing",  "workspaceId": "3d0f6c2e-8a41-4b57-9e2a-61c4f0b8d7a5",  "workspaceName": "Acme",  "plan": "business",  "planName": "Business",  "metered": true,  "interval": "month",  "renewsAt": "2026-11-01T09:00:00.000Z",  "cancelAtPeriodEnd": false,  "nextCharge": { "cents": 10000, "currency": "usd", "at": "2026-11-01T09:00:00.000Z" },  "domains": { "used": 3, "included": 500, "canAdd": true },  "usage": {    "sends": { "used": 18240, "limit": 200000, "resetsAt": "2026-11-01T00:00:00.000Z" },    "aiActions": { "used": 12, "limit": 150, "resetsAt": "2026-10-04T00:00:00.000Z" }  },  "payAsYouGo": {    "available": true,    "enabled": true,    "suspended": false,    "enrolled": true,    "switchedOn": true,    "coversSends": true,    "coversAiActions": true,    "limitCents": 5000,    "spentCents": 120,    "extraSends": 3000,    "extraAiActions": 0,    "estimatedCents": 120  },  "availablePlans": ["free", "starter", "business", "enterprise"]}

metered равен false, когда оплата на этой установке выключена, и тогда ничего не ограничено.

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

Справочник