/api/gateway/usage/eventsList settled usage events
Keyset pages of settled requests, newest first. Pass next_cursor back as cursor. 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).
api_key_idstringRestrict to one API key.
fromstringFirst day, inclusive (
YYYY-MM-DD).tostringLast day, inclusive (
YYYY-MM-DD).cursorstringOpaque cursor from the previous page.
limitintegerPage size, clamped to 1..200.
Responses
200One page.
Response
org_idstringrequiredeventsarray<object>requiredevents
request_idstringrequiredapi_key_idstring | nullrequireduser_idstring | nullrequiredaliasstringrequiredModel slug requested.
providerstring | nullrequiredProvider that served it; masked house lanes read
experiential_cloud.laneenumrequiredplatform_funded= platform credits;pass_through= your own provider key. Null when nothing was dispatched.input_tokensintegerrequiredoutput_tokensintegerrequiredcached_input_tokensintegerrequiredPart of
input_tokensserved from the provider's prompt cache.reasoning_tokensintegerrequiredPart of
output_tokensspent on reasoning.cost_nano_usdintegerrequiredCharged to platform credits, integer nano-USD.
estimated_cost_nano_usdintegerrequiredNever-charged estimate for BYOK traffic at list price, integer nano-USD.
free_nano_usdintegerrequiredList-price value of the promotion-funded portion, integer nano-USD (both cost columns are 0 for it).
latency_msinteger | nullrequiredstatusenumrequiredattempt_countintegerrequiredProvider dispatches; 0 = refused before dispatch.
daystringrequiredcreated_atstringrequired
next_cursorstring | nullrequiredOpaque. Pass back as
cursorfor the next page; null when this page ended the stream.
400Malformed date or cursor.
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).
Request
curl https://api.experientiallabs.ai/api/gateway/usage/events?org_id=3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10&api_key_id=6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33&from=2026-11-17&to=2026-11-18&cursor=MjAyNi0xMS0xOHwyMDI2LTExLTE4VDE0OjMyOjA3LjQ4MVp8cmVxXzAxSkQ4Wks0&limit=100 \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"org_id": "3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10",
"events": [
{
"request_id": "req_01JD8ZK4M2Q7V9X3N5T6B8C0EF",
"api_key_id": "6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33",
"user_id": null,
"alias": "gpt-6-luna",
"provider": "experiential_cloud",
"lane": "platform_funded",
"input_tokens": 4210,
"output_tokens": 388,
"cached_input_tokens": 3584,
"reasoning_tokens": 120,
"cost_nano_usd": 1284000,
"estimated_cost_nano_usd": 0,
"free_nano_usd": 0,
"latency_ms": 2140,
"status": "completed",
"attempt_count": 1,
"day": "2026-11-18",
"created_at": "2026-11-18T14:32:07.481Z"
}
],
"next_cursor": null
}https://api.experientiallabs.ai/api/gateway/usage/events?org_id=3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10&api_key_id=6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33&from=2026-11-17&to=2026-11-18&cursor=MjAyNi0xMS0xOHwyMDI2LTExLTE4VDE0OjMyOjA3LjQ4MVp8cmVxXzAxSkQ4Wks0&limit=100