v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB

Organization Billing

Get Current Usage

Get current month usage.

Returns credit consumption for the current billing period, estimated cost, and next invoice date.

Requirements:

Read permission

Example:

response = await client.get("/v1/organizations/billing/usage/current")
print(f"Usage: {response['current_month_usage']} credits")
print(f"Estimated cost: ${response['estimated_cost_usd']}")

get/v1/organizations/billing/usage/current

Response

Successful Response

current_month_usageinteger required

Credits consumed in current billing cycle

billing_monthstring required

Current billing month (YYYY-MM)

billing_period_startstring date-time required

Start of current billing period

billing_period_endstring date-time required

End of current billing period

estimated_cost_usdnumber required

Estimated cost for current usage

credit_ratenumber

Cost per credit in USD

auto_billing_enabledboolean required

Whether auto-billing is enabled

next_invoice_datestring date-time required

When next invoice will be generated

usage_v2object nullable

Modality+features usage for the period (contract v2 §2): dollars by modality and feature, unit counts, estimated flag. SHADOW data until cutover — informational alongside the credit fields above. None if no v2 records exist yet or aggregation fails (best-effort).

Example response

{
  "current_month_usage": 23450,
  "billing_month": "2025-12",
  "estimated_cost_usd": 23.45,
  "plan_usage": {
    "product": "managed",
    "tier": "build",
    "plan_name": "Build",
    "monthly_minimum_cents": 2500,
    "objects_processed": 41230,
    "object_cap": 100000,
    "usage_pct": 41.2,
    "cap_state": "ok"
  },
  "slack_invite": {
    "channel_name": "ext-mixpeek-acme-com"
  }
}