Skip to main content
GET
Get the platform billing summary (Admin only)

Authorizations

Authorization
string
header
required

JWT access token for user authentication (Authorization: Bearer <jwt_token>). Create via POST /users/me/access_tokens.

Response

Billing summary retrieved successfully

Platform billing summary — credit LIMITS (caps) and consumption.

These are spend-limit ceilings from organization_limits_history, NOT payments or cash received. Real money-in (Stripe top-ups) lives in the billing service (nearai-cloud-ui), not in cloud-api.

active_grant_credit_limit_usd
number<double>
required

Sum of active grant-type spend limits (caps), USD

active_paid_credit_limit_usd
number<double>
required

Sum of active payment-type spend limits (caps), USD

by_source
object[]
required
generated_at
string<date-time>
required
granted_org_count
integer<int64>
required
inference_consumed_usd
number<double>
required

All-time inference consumed cost, USD (organization_usage_log)

paying_org_count
integer<int64>
required
service_consumed_usd
number<double>
required

All-time service consumed cost, USD (organization_service_usage_log, e.g. web_search)

total_consumed_usd
number<double>
required

All-time consumed cost across all orgs, USD — all usage (from organization_balance: inference + services). inference_consumed_usd + service_consumed_usd reconcile to this.