GET/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_idstringrequired

    Your organization id (uuid). GET /api/whoami returns it.

  • request_idstringrequired

    The request id (the x-request-id a completion returned).

Query parameters

  • include_bodyboolean

    Inline the captured prompt and response.

    Default: false

Responses

  • 200

    The request.

    Response
    • request_idstringrequired
    • modelstringrequired
    • providerstring | nullrequired

      Customer-facing provider (masked house lanes read experiential_cloud); null when nothing was dispatched.

    • laneenumrequired
      "platform""byok"null
    • api_key_idstring | nullrequired
    • key_labelstring | nullrequired
    • input_tokensintegerrequired
    • output_tokensintegerrequired
    • cached_input_tokensintegerrequired

      Cache hits as billed, including cache_credited_input_tokens.

    • cache_credited_input_tokensinteger

      Input the platform billed at the cached rate because it caused the cache miss.

      Default: 0
    • reasoning_tokensintegerrequired
    • cost_usdnumberrequired

      Charged platform credits, dollars (0 for BYOK).

    • estimated_cost_usdnumberrequired

      Never-charged BYOK estimate, dollars.

    • free_usdnumberrequired

      List-price value of promotion-funded usage, dollars.

    • real_cost_usdnumberrequired

      cost_usd + estimated_cost_usd.

    • pricing_knownbooleanrequired

      False when the winning attempt had no known price: a 0 cost then means unpriced, not free.

    • latency_msinteger | nullrequired
    • ttft_msinteger | nullrequired

      Time to first streamed token; null when not observed.

    • statusenumrequired
      "completed""failed""cancelled""incomplete""expired_before_dispatch""unknown_after_crash"
    • deliveryobject | null

      Null means not observed, never completed.

      One of

      object

      • request_idstringrequired
      • outcomeenumrequired
        "completed""relay_closed""inspection_unknown""send_failed""exception""client_disconnect_observed"
      • streamingbooleanrequired
      • terminal_frame_seenbooleanrequired
      • final_body_sentbooleanrequired
      • client_disconnect_observedbooleanrequired
      • inspection_completebooleanrequired
      • bytes_sentintegerrequired
      • body_messages_sentintegerrequired
      • data_frames_sentintegerrequired
      • started_atstringrequired
      • observed_atstringrequired
      • duration_msintegerrequired
    • usage_evidenceobject | null
      One of

      object

      • usage_sourceenumrequired
        "observed""estimated""unknown"
      • input_tokensinteger | nullrequired
      • output_tokensinteger | nullrequired
      • cached_input_tokensinteger | nullrequired
      • reasoning_tokensinteger | nullrequired
      • no_dispatchbooleanrequired
      • cache_write_input_tokensinteger | nullrequired

        Input written to the provider cache (billed at the cache-write rate).

    • web_search_requestsinteger | null
    • web_search_fee_usdnumber | null

      Dollars, already inside the cost fields.

    • attempt_countintegerrequired

      Physical provider dispatches; 0 = refused before dispatch.

    • created_atstringrequired
    • tools_usedarray<string>required

      Distinct tool names (never arguments).

    • failure_classstring | nullrequired

      Sanitized outcome class for a non-completed request.

    • error_messagestring | nullrequired
    • incomplete_reasonenum
      "max_tokens""provider_stream_ended""tool_call_cut""context_window""unknown"null
    • prompt_groupstring | nullrequired

      12-hex handle: requests sharing it ran the same agent configuration.

    • conversation_groupstring | nullrequired

      12-hex handle: requests sharing it belong to one conversation.

    • attribution_labelstring | nullrequired
    • tagsobject

      Call tags sent in X-Explabs-Tags.

    • bodyobject | null

      With include_body=true; null when not asked for or nothing was captured.

      One of

      object

      • request_idstringrequired
      • messagesarray<object>required
      • captured_atstringrequired
      • responseobject | null

        What the caller received: {kind: json, body} or {kind: sse, frames: [...]}; a stream the caller left early carries client_disconnected: true. Null until relayed.

      • response_captured_atstring | null
      • requestobject | null

        The request envelope minus messages (tools, tool_choice, sampling and reasoning settings).

      • wire_requestobject | null

        The request as the gateway received it (method, path, query, redacted headers, exact body).

  • 401

    Missing, unknown or revoked API key.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    Unknown request in this organization.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 429

    Too 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 after Retry-After.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-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