Skip to main content
GET
/
v1
/
organizations
/
billing
/
usage
/
breakdown
Get Usage Breakdown
curl --request GET \
  --url https://api.mixpeek.com/v1/organizations/billing/usage/breakdown \
  --header 'Authorization: <authorization>'
{
  "billing_month": "<string>",
  "total_credits": 123,
  "total_cost_usd": 123,
  "by_operation": {},
  "by_extractor": {},
  "period_start": "2023-11-07T05:31:56Z",
  "period_end": "2023-11-07T05:31:56Z"
}

Headers

​
Authorization
string
required

REQUIRED: Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.

Query Parameters

​
billing_month
string | null

Billing month in YYYY-MM format (defaults to current month)

Example:

"2025-12"

Response

Successful Response

Response with detailed usage breakdown.

​
billing_month
string
required

Billing month (YYYY-MM)

​
total_credits
integer
required

Total credits consumed

​
total_cost_usd
number
required

Total cost in USD

​
by_operation
By Operation · object
required

Credits consumed by operation type

​
by_extractor
By Extractor · object
required

Credits consumed by extractor

​
period_start
string<date-time>
required

Start of billing period

​
period_end
string<date-time>
required

End of billing period