Usage API reference

Generated from the OpenAPI specification (version 2026-10-01). Base URL: https://app.meetingize.com/api. All requests need Authorization: Bearer <API key or OAuth token>. Try them in the API explorer.

Current consumption

GET /v1/usage

Consumption of the current period (UTC calendar month): wallet (allowance included in your plan + credits), on-demand part and spend cap, totals (tokens, audio seconds) and the unit prices applied. Required scope: read:usage.

Responses

• 200:
• 400: Validation error
• 401: Missing or invalid credential
• 403: Insufficient scope
• 404: Not found (also for resources of other accounts)
• 429: Rate limit (rate_limited) or parallel processing quota (parallel_processing_limit) exceeded; see Retry-After

Response fields (200)

Field	Type	Required	Description
object	string	yes
period	string	yes
period_start	string (date-time)	yes
period_end	string (date-time)	yes
currency	string	yes
wallet	object	yes
on_demand	object	yes
totals	object	yes
alert_thresholds_percent	array of integer	yes
rates	object	yes

curl -s "https://app.meetingize.com/api/v1/usage" \
  -H "Authorization: Bearer $MEETINGIZE_API_KEY"

Consumption ledger

GET /v1/usage/ledger

One immutable line per metered operation (transcription, AI report, document), with tokens, model, cost and how it was paid (wallet / on-demand / written off above the cap). Required scope: read:usage.

Parameter	In	Type	Required	Description
cursor	query	string
limit	query	integer
period	query	string		Billing period YYYY-MM (UTC). Default: current month.

Responses

• 200:
• 400: Validation error
• 401: Missing or invalid credential
• 403: Insufficient scope
• 404: Not found (also for resources of other accounts)
• 429: Rate limit (rate_limited) or parallel processing quota (parallel_processing_limit) exceeded; see Retry-After

Response fields (200)

Field	Type	Required	Description
data	array of object	yes
has_more	boolean	yes
next_cursor	string | null	yes

curl -s "https://app.meetingize.com/api/v1/usage/ledger" \
  -H "Authorization: Bearer $MEETINGIZE_API_KEY"