Skip to main content
Get usage summary

Authorizations

Authorization
string
header
required

Live API key minted in the dashboard. Pass as Authorization: Bearer sk_live_…. Keys are scoped to a single environment (staging / prod).

Query Parameters

period
enum<string> | null

Convenience period selector; mutually exclusive with explicit range.

Available options:
current_month,
previous_month
period_start
string<date-time> | null

ISO-8601 UTC. Must be paired with period_end.

period_end
string<date-time> | null

ISO-8601 UTC. Must be paired with period_start.

Response

Successful Response

Aggregated usage; returned by GET /v1/usage.

billable_seconds
integer
required

Total billable seconds across all sessions in the window.

Required range: x >= 0
period_end
string<date-time>
required

Exclusive end of the aggregated window. Matches the period_end query argument.

period_start
string<date-time>
required

Inclusive start of the aggregated window. Matches the period_start query argument.

sessions
integer
required

Number of sessions that contributed usage in the window.

Required range: x >= 0
by_billing_surface
object

credits_charged per billing surface.

by_quality
object

billable_seconds per quality tier. Forward-compatible breakdown — additional by_* slices may appear over time.

by_speech_billing_mode
object

credits_charged per speech billing mode.

credits_charged
integer
default:0

Total credits charged across all usage events in the window.

Required range: x >= 0
daily_credits_by_billing_surface
object

credits_charged per UTC day and billing surface. Keys use YYYY-MM-DD.