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']}")
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Response
Successful Response
Response with current month usage.
Credits consumed in current billing cycle
23450
Current billing month (YYYY-MM)
"2025-12"
Start of current billing period
End of current billing period
Estimated cost for current usage
23.45
Whether auto-billing is enabled
When next invoice will be generated
Cost per credit in USD
Tier usage vs caps (objects for managed, vectors for MVS). None only if plan resolution fails.
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).

