/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.
認証: AuthorizationヘッダーにBearer形式のAPIキー
クエリパラメータ
org_idstring必須Your 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.
レスポンス
200Usage rows.
レスポンス
org_idstring必須scopeenum必須group_byenum必須rowsarray<object>必須rows
daystring | null必須Viewer-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 | null必須Member id on
group_by=member; null otherwise, and null for members of a deleted organization.aliasstring | null必須Model slug on
model,day_modelandhour_model.requestsinteger必須Requests in the bucket, pre-dispatch refusals included.
input_tokensinteger必須output_tokensinteger必須spend_nano_usdinteger必須Charged plus the BYOK list-price estimate, integer nano-USD (1 USD = 1,000,000,000).
paid_nano_usdinteger必須The charged part alone (credits actually debited), integer nano-USD.
free_nano_usdinteger必須List-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.レスポンス
errorstring必須Human-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.
レスポンス
errorstring必須Human-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.
レスポンス
errorstring必須Human-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.
レスポンス
errorstring必須Human-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.
レスポンス
errorstring必須Human-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).
リクエスト
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"レスポンス
{
"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