Get usage
Aggregate the org’s memory MONTHLY rollup rows for the current calendar month, plus DAILY rows if requested, plus an inline Qdrant storage snapshot.
operationstotalsmessages_ingested/recalls/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>.
Required alongside the API key (no key→org reverse index).
Headers
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 joined to APIKEY#{hash} for name / first_n. Off by default — extra DDB scans.
Response
Successful Response
Top-level shape for GET /v1/usage.
When this snapshot was computed.
Currently-active per-type row counts from Qdrant.
Cached harder than operations (count(filter) is expensive);
as_of reflects the mint time of the cached snapshot and may
lag the response-level as_of.
"usage"Canonical tier value from ORG#SUB; 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.