Skip to main content
GET
Get usage

Authorizations

x-api-key
string
header
required

Long-lived org API key. Alternative: Authorization: Bearer <key>.

Query Parameters

daily
boolean
default:false

Include the per-day daily[] array (one entry per calendar day in the period). Off by default to keep the response cheap; the dashboard chart opts in.

by_api_key
boolean
default:false

Include the per-API-key breakdown with each key's name / first_n display fields. Off by default — adds extra lookups.

org_id
string | null

Response

Successful Response

Top-level shape for GET /v1/usage.

as_of
string
required

When this snapshot was computed.

period
Period · object
required
storage
StorageSnapshot · object
required

Currently-active per-type row counts.

Cached harder than operations (computing the counts is expensive); as_of reflects the mint time of the cached snapshot and may lag the response-level as_of.

quota
Quota · object
required
object
string
default:usage
Allowed value: "usage"
tier
string | null

The org's subscription tier; None if unset.

operations
Operations · object

Period-total memory operation counters for the org.

daily
DailyEntry · object[] | null

None when ?daily=false (default); populated when ?daily=true.

by_api_key
ByApiKeyEntry · object[] | null

None when ?by_api_key=false (default); populated when ?by_api_key=true.