Get usage summary
Return aggregated usage for the calling org over a time range.
Pass either period=current_month (or previous_month) for convenience, or an explicit period_start / period_end pair. The two modes are mutually exclusive.
Authorizations
Live API key minted in the dashboard. Pass as Authorization: Bearer sk_live_…. Keys are scoped to a single environment (staging / prod).
Query Parameters
Convenience period selector; mutually exclusive with explicit range.
current_month, previous_month ISO-8601 UTC. Must be paired with period_end.
ISO-8601 UTC. Must be paired with period_start.
Response
Successful Response
Aggregated usage; returned by GET /v1/usage.
Total billable seconds across all sessions in the window.
x >= 0Exclusive end of the aggregated window. Matches the period_end query argument.
Inclusive start of the aggregated window. Matches the period_start query argument.
Number of sessions that contributed usage in the window.
x >= 0credits_charged per billing surface.
billable_seconds per quality tier. Forward-compatible breakdown — additional by_* slices may appear over time.
credits_charged per speech billing mode.
Total credits charged across all usage events in the window.
x >= 0credits_charged per UTC day and billing surface. Keys use YYYY-MM-DD.

