/api/orgs/{org_id}/usage/by-providerRoll up usage per provider
One row per customer-facing provider; provider: null groups requests where nothing was dispatched.
Authentication: Bearer API key in the Authorization header
Path parameters
org_idstringrequiredYour organization id (uuid).
GET /api/whoamireturns it.
Query parameters
windowenumLookback window ending now.
24hbuckets hourly,7dand30ddaily.modelstringRestrict to one model slug (the alias the caller requested).
api_key_idstringRestrict to one API key (uuid).
laneenumRestrict to one money lane:
platform(platform credits) orbyok(your own provider key, never charged). A lane cut excludes requests where nothing was dispatched.
Responses
200Per-provider rollup.
Response
windowenumrequiredprovidersarray<object>requiredHighest charged plus estimated spend first.
providers
providerstring | nullrequiredWinning attempt's provider (masked house lanes read
experiential_cloud); null groups requests where nothing was dispatched.request_countintegerrequiredEvery finished request, errors and pre-dispatch refusals included.
error_countintegerrequiredSubset whose terminal state was not
completed.input_tokensintegerrequiredoutput_tokensintegerrequiredcost_usdnumberrequiredCharged platform credits, dollars.
estimated_cost_usdnumberrequiredNever-charged BYOK estimate at list price, dollars.
free_usdnumberrequiredList-price value of promotion-funded usage, dollars (never charged).
last_used_atstringrequired
400Unknown window or lane, or a malformed
api_key_id.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).
429Too many reads.
rate_limited: this organization's API-key reads of the request log are over about 10 per second (burst 30) or 4 in flight on one server (sessions are not limited).build_capacity: the shared analytics read slots are busy. Retry afterRetry-After.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/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/usage/by-provider?window=24h&model=gpt-6-luna&api_key_id=6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33&lane=platform \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"window": "7d",
"providers": [
{
"provider": "experiential_cloud",
"request_count": 10220,
"error_count": 38,
"input_tokens": 41204410,
"output_tokens": 3120400,
"cost_usd": 18.42,
"estimated_cost_usd": 0,
"free_usd": 1.1,
"last_used_at": "2026-11-18T14:32:07.481Z"
},
{
"provider": null,
"request_count": 61,
"error_count": 61,
"input_tokens": 0,
"output_tokens": 0,
"cost_usd": 0,
"estimated_cost_usd": 0,
"free_usd": 0,
"last_used_at": "2026-11-18T11:02:40Z"
}
]
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/usage/by-provider?window=24h&model=gpt-6-luna&api_key_id=6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33&lane=platform