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
{
  "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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Authorization
string

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

Examples:

"Bearer YOUR_API_KEY"

"Bearer YOUR_STRIPE_API_KEY"

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)

Example:

"2025-12"

​
total_credits
integer
required

Total credits consumed

Example:

23450

​
total_cost_usd
number
required

Total cost in USD

Example:

23.45

​
by_operation
By Operation · object
required

Credits consumed by operation type

Example:
{
  "batch": 2450,
  "extractor": 15000,
  "search": 1000,
  "upload": 5000
}
​
by_extractor
By Extractor · object
required

Credits consumed by extractor

Example:
{
  "multimodal_extractor": 10000,
  "text_extractor": 5000
}
​
period_start
string<date-time>
required

Start of billing period

​
period_end
string<date-time>
required

End of billing period