/api/orgs/{org_id}/usage/requestsList requests
Newest first unless sort is set. While next_cursor is not null, resend the same query with its fields as cursor_ts, cursor_id, cursor_after (plus cursor_value, cursor_before on a sorted page). Customer-plan keys see only their own identity's requests and cannot use sort, failure_class or conversation.
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.statusenumTerminal state, or
errorfor every state other thancompleted.limitintegerRows per page, 1 to 200. Out of range answers 422.
attribution_labelstringRestrict to one end-user label.
cache_hits_onlybooleanOnly requests with recorded cached input tokens.
failure_classstringOne error class (non-completed requests only), for example
provider_timeout.conversationstringOne conversation: the 8 to 64 lower-case hex handle the log shows.
startstringExact range start, inclusive (ISO 8601). Replaces
window.endstringExact range end, exclusive (ISO 8601).
sortenumtime(default, newest first),oldest, or largest first bycost,latencyortokens. Not combinable withfailure_classorconversation.cursor_tsstringnext_cursor.ts.cursor_idstringnext_cursor.id; pass withcursor_ts.cursor_afterstringnext_cursor.after: freezes the window's lower bound across pages.cursor_valuestringnext_cursor.value(figure sorts only).cursor_beforestringnext_cursor.before(sorted pages only).
Responses
200One page.
Response
requestsarray<object>requiredrequests
request_idstringrequiredmodelstringrequiredproviderstring | nullrequiredCustomer-facing provider (masked house lanes read
experiential_cloud); null when nothing was dispatched.laneenumrequiredapi_key_idstring | nullrequiredkey_labelstring | nullrequiredinput_tokensintegerrequiredoutput_tokensintegerrequiredcached_input_tokensintegerrequiredCache hits as billed, including
cache_credited_input_tokens.cache_credited_input_tokensintegerInput the platform billed at the cached rate because it caused the cache miss.
reasoning_tokensintegerrequiredcost_usdnumberrequiredCharged platform credits, dollars (0 for BYOK).
estimated_cost_usdnumberrequiredNever-charged BYOK estimate, dollars.
free_usdnumberrequiredList-price value of promotion-funded usage, dollars.
real_cost_usdnumberrequiredcost_usd+estimated_cost_usd.pricing_knownbooleanrequiredFalse when the winning attempt had no known price: a 0 cost then means unpriced, not free.
latency_msinteger | nullrequiredttft_msinteger | nullrequiredTime to first streamed token; null when not observed.
statusenumrequireddeliveryobject | nullNull means not observed, never completed.
One of
object
request_idstringrequiredoutcomeenumrequiredstreamingbooleanrequiredterminal_frame_seenbooleanrequiredfinal_body_sentbooleanrequiredclient_disconnect_observedbooleanrequiredinspection_completebooleanrequiredbytes_sentintegerrequiredbody_messages_sentintegerrequireddata_frames_sentintegerrequiredstarted_atstringrequiredobserved_atstringrequiredduration_msintegerrequired
usage_evidenceobject | nullOne of
object
usage_sourceenumrequiredinput_tokensinteger | nullrequiredoutput_tokensinteger | nullrequiredcached_input_tokensinteger | nullrequiredreasoning_tokensinteger | nullrequiredno_dispatchbooleanrequiredcache_write_input_tokensinteger | nullrequiredInput written to the provider cache (billed at the cache-write rate).
web_search_requestsinteger | nullweb_search_fee_usdnumber | nullDollars, already inside the cost fields.
attempt_countintegerrequiredPhysical provider dispatches; 0 = refused before dispatch.
created_atstringrequiredtools_usedarray<string>requiredDistinct tool names (never arguments).
failure_classstring | nullrequiredSanitized outcome class for a non-completed request.
error_messagestring | nullrequiredincomplete_reasonenumprompt_groupstring | nullrequired12-hex handle: requests sharing it ran the same agent configuration.
conversation_groupstring | nullrequired12-hex handle: requests sharing it belong to one conversation.
attribution_labelstring | nullrequiredtagsobjectCall tags sent in
X-Explabs-Tags.
next_cursorobject | nullrequiredSet while a full page came back.
One of
object
tsstringrequiredidstringrequiredafterstringrequiredvaluestring | nullLast row's sort figure (sorted pages only).
beforestring | nullFrozen upper bound (sorted pages only).
400Bad filter, cursor or range.
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).
422limitout of range, or a filtered figure sort too broad to read (sort_too_broad).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).
Request
curl https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/usage/requests?window=24h&model=gpt-6-luna&api_key_id=6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33&lane=platform&status=error&limit=50&attribution_label=user_48121&cache_hits_only=false&failure_class=quota_exceeded&conversation=f02a6b19c4e8&start=2026-11-18T14%3A00%3A00Z&end=2026-11-18T15%3A00%3A00Z&sort=cost&cursor_ts=2026-11-18T14%3A32%3A07.481Z&cursor_id=req_01JD8ZK4M2Q7V9X3N5T6B8C0EF&cursor_after=2026-11-17T14%3A32%3A00Z&cursor_value=1284000&cursor_before=2026-11-18T14%3A32%3A07Z \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"requests": [
{
"request_id": "req_01JD8ZK4M2Q7V9X3N5T6B8C0EF",
"model": "gpt-6-luna",
"provider": "experiential_cloud",
"lane": "platform",
"api_key_id": "6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33",
"key_label": "support-bot",
"input_tokens": 4210,
"output_tokens": 388,
"cached_input_tokens": 3584,
"cache_credited_input_tokens": 0,
"reasoning_tokens": 120,
"cost_usd": 0.001284,
"estimated_cost_usd": 0,
"free_usd": 0,
"real_cost_usd": 0.001284,
"pricing_known": true,
"latency_ms": 2140,
"ttft_ms": 410,
"status": "completed",
"delivery": {
"request_id": "req_01JD8ZK4M2Q7V9X3N5T6B8C0EF",
"outcome": "completed",
"streaming": true,
"terminal_frame_seen": true,
"final_body_sent": true,
"client_disconnect_observed": false,
"inspection_complete": true,
"bytes_sent": 18422,
"body_messages_sent": 96,
"data_frames_sent": 94,
"started_at": "2026-11-18T14:32:05.330Z",
"observed_at": "2026-11-18T14:32:07.470Z",
"duration_ms": 2140
},
"usage_evidence": {
"usage_source": "observed",
"input_tokens": 4210,
"output_tokens": 388,
"cached_input_tokens": 3584,
"reasoning_tokens": 120,
"no_dispatch": false,
"cache_write_input_tokens": null
},
"web_search_requests": null,
"web_search_fee_usd": null,
"attempt_count": 1,
"created_at": "2026-11-18T14:32:07.481Z",
"tools_used": [
"lookup_order"
],
"failure_class": null,
"error_message": null,
"incomplete_reason": null,
"prompt_group": "9c41e07ab2d3",
"conversation_group": "f02a6b19c4e8",
"attribution_label": "user_48121",
"tags": {}
}
],
"next_cursor": {
"ts": "2026-11-18T14:32:07.481Z",
"id": "req_01JD8ZK4M2Q7V9X3N5T6B8C0EF",
"after": "2026-11-17T14:32:00Z",
"value": null,
"before": null
}
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/usage/requests?window=24h&model=gpt-6-luna&api_key_id=6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33&lane=platform&status=error&limit=50&attribution_label=user_48121&cache_hits_only=false&failure_class=quota_exceeded&conversation=f02a6b19c4e8&start=2026-11-18T14%3A00%3A00Z&end=2026-11-18T15%3A00%3A00Z&sort=cost&cursor_ts=2026-11-18T14%3A32%3A07.481Z&cursor_id=req_01JD8ZK4M2Q7V9X3N5T6B8C0EF&cursor_after=2026-11-17T14%3A32%3A00Z&cursor_value=1284000&cursor_before=2026-11-18T14%3A32%3A07Z