Get usage
Aggregate the org’s memory usage for the current quota period — a calendar month, or your billing period on plans that meter per billing period — plus a per-day breakdown if requested, plus an inline storage snapshot.
operationstotalsmessages_ingested/searches/requestsacross every API key for the period.quota.monthlypairs those totals against the plan caps resolved from the org’s subscription tier;limit: nullmeans the tier is uncapped (enterprise).quota.rate_limit_req_per_minis the per-API-key request ceiling enforced across all memory endpoints.
Authorizations
Long-lived org API key. Alternative: Authorization: Bearer <key>.
Query Parameters
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.
Include the per-API-key breakdown with each key's name / first_n display fields. Off by default — adds extra lookups.
Response
Successful Response
Top-level shape for GET /v1/usage.
When this snapshot was computed.
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.
"usage"The org's subscription tier; None if unset.
Period-total memory operation counters for the org.
None when ?daily=false (default); populated when ?daily=true.
None when ?by_api_key=false (default); populated when ?by_api_key=true.