/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.
認証: AuthorizationヘッダーにBearer形式のAPIキー
パスパラメータ
org_idstring必須Your organization id (uuid).
GET /api/whoamireturns it.
クエリパラメータ
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).
レスポンス
200One page.
レスポンス
requestsarray<object>必須requests
request_idstring必須modelstring必須providerstring | null必須Customer-facing provider (masked house lanes read
experiential_cloud); null when nothing was dispatched.laneenum必須api_key_idstring | null必須key_labelstring | null必須input_tokensinteger必須output_tokensinteger必須cached_input_tokensinteger必須Cache 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_tokensinteger必須cost_usdnumber必須Charged platform credits, dollars (0 for BYOK).
estimated_cost_usdnumber必須Never-charged BYOK estimate, dollars.
free_usdnumber必須List-price value of promotion-funded usage, dollars.
real_cost_usdnumber必須cost_usd+estimated_cost_usd.pricing_knownboolean必須False when the winning attempt had no known price: a 0 cost then means unpriced, not free.
latency_msinteger | null必須ttft_msinteger | null必須Time to first streamed token; null when not observed.
statusenum必須deliveryobject | nullNull means not observed, never completed.
いずれか
object
request_idstring必須outcomeenum必須streamingboolean必須terminal_frame_seenboolean必須final_body_sentboolean必須client_disconnect_observedboolean必須inspection_completeboolean必須bytes_sentinteger必須body_messages_sentinteger必須data_frames_sentinteger必須started_atstring必須observed_atstring必須duration_msinteger必須
usage_evidenceobject | nullいずれか
object
usage_sourceenum必須input_tokensinteger | null必須output_tokensinteger | null必須cached_input_tokensinteger | null必須reasoning_tokensinteger | null必須no_dispatchboolean必須cache_write_input_tokensinteger | null必須Input 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_countinteger必須Physical provider dispatches; 0 = refused before dispatch.
created_atstring必須tools_usedarray<string>必須Distinct tool names (never arguments).
failure_classstring | null必須Sanitized outcome class for a non-completed request.
error_messagestring | null必須incomplete_reasonenumprompt_groupstring | null必須12-hex handle: requests sharing it ran the same agent configuration.
conversation_groupstring | null必須12-hex handle: requests sharing it belong to one conversation.
attribution_labelstring | null必須tagsobjectCall tags sent in
X-Explabs-Tags.
next_cursorobject | null必須Set while a full page came back.
いずれか
object
tsstring必須idstring必須afterstring必須valuestring | nullLast row's sort figure (sorted pages only).
beforestring | nullFrozen upper bound (sorted pages only).
400Bad filter, cursor or range.
レスポンス
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).
422limitout of range, or a filtered figure sort too broad to read (sort_too_broad).レスポンス
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).
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.レスポンス
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/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"レスポンス
{
"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