GET/api/orgs/{org_id}/usage/requests

List 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_idstringrequired

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

Query parameters

  • windowenum

    Lookback window ending now. 24h buckets hourly, 7d and 30d daily.

    "24h""7d""30d"
    Default: "7d"
  • modelstring

    Restrict to one model slug (the alias the caller requested).

  • api_key_idstring

    Restrict to one API key (uuid).

  • laneenum

    Restrict to one money lane: platform (platform credits) or byok (your own provider key, never charged). A lane cut excludes requests where nothing was dispatched.

    "platform""byok"
  • statusenum

    Terminal state, or error for every state other than completed.

    "error""completed""failed""cancelled""incomplete""expired_before_dispatch""unknown_after_crash"
  • limitinteger

    Rows per page, 1 to 200. Out of range answers 422.

    Default: 50
  • attribution_labelstring

    Restrict to one end-user label.

  • cache_hits_onlyboolean

    Only requests with recorded cached input tokens.

    Default: false
  • failure_classstring

    One error class (non-completed requests only), for example provider_timeout.

  • conversationstring

    One conversation: the 8 to 64 lower-case hex handle the log shows.

  • startstring

    Exact range start, inclusive (ISO 8601). Replaces window.

  • endstring

    Exact range end, exclusive (ISO 8601).

  • sortenum

    time (default, newest first), oldest, or largest first by cost, latency or tokens. Not combinable with failure_class or conversation.

    "time""oldest""cost""latency""tokens"
    Default: "time"
  • cursor_tsstring

    next_cursor.ts.

  • cursor_idstring

    next_cursor.id; pass with cursor_ts.

  • cursor_afterstring

    next_cursor.after: freezes the window's lower bound across pages.

  • cursor_valuestring

    next_cursor.value (figure sorts only).

  • cursor_beforestring

    next_cursor.before (sorted pages only).

Responses

  • 200

    One page.

    Response
    • requestsarray<object>required
      requests
      • 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.

    • next_cursorobject | nullrequired

      Set while a full page came back.

      One of

      object

      • tsstringrequired
      • idstringrequired
      • afterstringrequired
      • valuestring | null

        Last row's sort figure (sorted pages only).

      • beforestring | null

        Frozen upper bound (sorted pages only).

  • 400

    Bad filter, cursor or range.

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

  • 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 organization, or not the key's own 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).

  • 422

    limit out of range, or a filtered figure sort too broad to read (sort_too_broad).

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