/api/gateway/usage/dailyGet grouped daily usage
API keys must pass scope=org (the default self is a signed-in member's own usage and answers 400 for a key). Requests include pre-dispatch refusals. Money is integer nano-USD.
Authentication: Bearer API key in the Authorization header
Query parameters
org_idstringrequiredYour organization id. Required (this route takes it as a query parameter).
scopeenumself(signed-in member only) ororg.user_idstringWith
scope=org, restrict to one member (uuid).fromstringFirst day, inclusive (
YYYY-MM-DD, intime_zone).tostringLast day, inclusive (
YYYY-MM-DD).group_byenumGrouping.
hourandhour_modelneed bothfromandto, at most 7 days apart.limitintegerRow cap, clamped to 1..2000 (1..24000 for
day_modelandhour_model).time_zonestringIANA zone for day boundaries.
Responses
200Usage rows.
Response
org_idstringrequiredscopeenumrequiredgroup_byenumrequiredrowsarray<object>requiredrows
daystring | nullrequiredViewer-local day on
day,day_modelandmember/modelgroupings that carry it; null on hour groupings.hourstring | nullStart instant of the UTC hour bucket on
hourandhour_model; absent or null otherwise.user_idstring | nullrequiredMember id on
group_by=member; null otherwise, and null for members of a deleted organization.aliasstring | nullrequiredModel slug on
model,day_modelandhour_model.requestsintegerrequiredRequests in the bucket, pre-dispatch refusals included.
input_tokensintegerrequiredoutput_tokensintegerrequiredspend_nano_usdintegerrequiredCharged plus the BYOK list-price estimate, integer nano-USD (1 USD = 1,000,000,000).
paid_nano_usdintegerrequiredThe charged part alone (credits actually debited), integer nano-USD.
free_nano_usdintegerrequiredList-price value of usage you were not charged for (promotion-funded plus waived discount), integer nano-USD. Not part of
spend_nano_usd.
400Bad date, zone, member id, hour window, or
scope=selffrom a key.Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
401Missing, unknown or revoked API key.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
404Unknown organization, or not the key's own organization.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
429The analytics read slots are busy.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
503Usage analytics are temporarily unavailable. Retry shortly.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
Request
curl https://api.experientiallabs.ai/api/gateway/usage/daily?org_id=3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10&scope=org&user_id=7a2e9c14-0b3d-4f61-8c25-9e4d1a6b0f72&from=2026-11-01&to=2026-11-18&group_by=day&limit=400&time_zone=America%2FNew_York \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"org_id": "3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10",
"scope": "org",
"group_by": "day",
"rows": [
{
"day": "2026-11-18",
"hour": null,
"user_id": null,
"alias": null,
"requests": 1842,
"input_tokens": 9120344,
"output_tokens": 612090,
"spend_nano_usd": 14273500000,
"paid_nano_usd": 11020000000,
"free_nano_usd": 850000000
},
{
"day": "2026-11-17",
"hour": null,
"user_id": null,
"alias": null,
"requests": 1610,
"input_tokens": 7804112,
"output_tokens": 540311,
"spend_nano_usd": 12001200000,
"paid_nano_usd": 9800500000,
"free_nano_usd": 0
}
]
}https://api.experientiallabs.ai/api/gateway/usage/daily?org_id=3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10&scope=org&user_id=7a2e9c14-0b3d-4f61-8c25-9e4d1a6b0f72&from=2026-11-01&to=2026-11-18&group_by=day&limit=400&time_zone=America%2FNew_York