Skip to main content
GET
Get today's usage

Authorizations

Authorization
string
header
required

An app API key, e.g. Authorization: Bearer sk_live_…. Secret (sk_) for writes/sessions; publishable (pk_) is read-only (browser-safe).

Response

Usage vs caps

day
string
Example:

"2026-06-28"

usage
object

Units used today, by kind (generation, session, session_seconds, edit, say, tts, image, seed_frame, probe, perceive, ground). Kinds with no usage today are omitted.

caps
object

This app's EFFECTIVE daily caps by kind: the global free-tier defaults merged with any per-app overrides granted to this app. Requests over a cap return 402 until the daily reset.

plan
string

The app's plan label (see App.billing_plan).

Example:

"free"

resets_at
string<date-time>

When the daily counters reset (next UTC midnight).