문서로 건너뛰기
API

요금제 읽기

워크스페이스의 요금제, 포함 내용, 사용한 양.

GET/billing

워크스페이스에 실제 호출을 실행합니다.

GET /billing

워크스페이스의 요금제, 포함 내용, 사용한 양.

예시

billing:read가 필요합니다. 요금제 및 결제가 보여 주는 내용입니다: 요금제의 청구 방식, 갱신 또는 종료 시점과 다음 청구, 도메인, 이번 달 발송량, 오늘의 AI 작업, 사용량 기반 요금. 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입니다.

레퍼런스