/api/orgs/{org_id}/usage/requests/{request_id}Get one request
Same projection as a list row. include_body=true inlines the captured prompt and response as body (null when nothing was captured).
Authentication: Bearer API key in the Authorization header
Path parameters
org_idstringrequiredYour organization id (uuid).
GET /api/whoamireturns it.request_idstringrequiredThe request id (the
x-request-ida completion returned).
Query parameters
include_bodybooleanInline the captured prompt and response.
Responses
200The request.
Response
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.bodyobject | nullWith
include_body=true; null when not asked for or nothing was captured.One of
object
request_idstringrequiredmessagesarray<object>requiredcaptured_atstringrequiredresponseobject | nullWhat the caller received:
{kind: json, body}or{kind: sse, frames: [...]}; a stream the caller left early carriesclient_disconnected: true. Null until relayed.response_captured_atstring | nullrequestobject | nullThe request envelope minus messages (tools, tool_choice, sampling and reasoning settings).
wire_requestobject | nullThe request as the gateway received it (method, path, query, redacted headers, exact body).
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 request in this 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).
Request
curl https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/usage/requests/req_01JD8ZK4M2Q7V9X3N5T6B8C0EF?include_body=true \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"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": {},
"body": {
"request_id": "req_01JD8ZK4M2Q7V9X3N5T6B8C0EF",
"messages": [
{
"role": "user",
"content": "Where is order 4471?"
}
],
"captured_at": "2026-11-18T14:32:07.481Z",
"response": {
"kind": "json",
"body": {
"id": "chatcmpl-8x2",
"object": "chat.completion"
}
},
"response_captured_at": "2026-11-18T14:32:07.481Z",
"request": {
"model": "gpt-6-luna",
"tools": [
{
"type": "function",
"function": {
"name": "lookup_order"
}
}
]
},
"wire_request": null
}
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/usage/requests/req_01JD8ZK4M2Q7V9X3N5T6B8C0EF?include_body=true