Get Usage Breakdown
Get detailed usage breakdown.
Returns usage breakdown by operation type and extractor for the specified billing period.
Query Parameters:
billing_month: Month to query (YYYY-MM format, defaults to current)
Requirements:
- Read permission
Example:
# Current month
response = await client.get("/v1/organizations/billing/usage/breakdown")
# Specific month
response = await client.get(
"/v1/organizations/billing/usage/breakdown",
params={"billing_month": "2025-11"}
)
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Billing month in YYYY-MM format (defaults to current month)
"2025-12"
Response
Successful Response
Response with detailed usage breakdown.
Billing month (YYYY-MM)
"2025-12"
Total credits consumed
23450
Total cost in USD
23.45
Credits consumed by operation type
Credits consumed by extractor
Start of billing period
End of billing period
Credits consumed by namespace (SP-242 — chargeback / cost-allocation for multi-namespace orgs). Keyed by namespace_id; excludes namespace-less consumption. Empty for older usage recorded before per-namespace attribution.
Credits consumed by retriever (per-product query-cost attribution for chargeback). Keyed by retriever_id (resource_type='retriever' charges: queries, enrichment). Empty when no retriever-attributed usage.
Unflushed sub-credit usage accrued but not yet committed to by_operation. Micro-priced per-op usage (e.g. MVS writes/queries at ~0.001 credit each) accumulates here and rolls into by_operation in whole credits as it crosses 1 — so real activity is visible immediately, before a whole credit accrues (BACKE-790).
0.014
Unflushed fractional credits by operation type.

