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).

認証: AuthorizationヘッダーにBearer形式のAPIキー

パスパラメータ

  • org_idstring必須

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

  • request_idstring必須

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

クエリパラメータ

  • include_bodyboolean

    Inline the captured prompt and response.

    デフォルト: false

レスポンス

  • 200

    The request.

    レスポンス
    • request_idstring必須
    • modelstring必須
    • providerstring | null必須

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

    • laneenum必須
      "platform""byok"null
    • 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_tokensinteger

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

      デフォルト: 0
    • 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必須
      "completed""failed""cancelled""incomplete""expired_before_dispatch""unknown_after_crash"
    • deliveryobject | null

      Null means not observed, never completed.

      いずれか

      object

      • request_idstring必須
      • outcomeenum必須
        "completed""relay_closed""inspection_unknown""send_failed""exception""client_disconnect_observed"
      • 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必須
        "observed""estimated""unknown"
      • 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 | null
    • web_search_fee_usdnumber | null

      Dollars, 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_reasonenum
      "max_tokens""provider_stream_ended""tool_call_cut""context_window""unknown"null
    • prompt_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必須
    • tagsobject

      Call tags sent in X-Explabs-Tags.

    • bodyobject | null

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

      いずれか

      object

      • request_idstring必須
      • messagesarray<object>必須
      • captured_atstring必須
      • 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.

    レスポンス
    • errorstring必須

      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.

    レスポンス
    • errorstring必須

      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.

    レスポンス
    • errorstring必須

      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).

リクエスト

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"

レスポンス

{
  "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