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

List a request's provider attempts

Every provider dispatch in order, at most 256. An unknown request id returns an empty list, not 404.

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

Responses

  • 200

    Attempts.

    Response
    • attemptsarray<object>required

      Dispatch order; empty when none ran or the request id is unknown.

      attempts
      • ordinalintegerrequired
      • providerstring | nullrequired
      • laneenumrequired
        "platform""byok"
      • stateenumrequired
        "dispatched""completed""failed""cancelled""incomplete""unknown_after_crash"
      • failure_classstring | nullrequired
      • error_messagestring | nullrequired

        Kept only for lanes shown under their real name (BYOK, unmasked house lanes).

      • started_atstring | nullrequired
      • terminal_atstring | nullrequired
      • input_tokensinteger | nullrequired
      • cached_input_tokensinteger | nullrequired
      • output_tokensinteger | nullrequired
      • reasoning_tokensinteger | nullrequired
      • tool_namesarray<string>required
    • truncatedbooleanrequired

      True when more than 256 dispatches exist.

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

  • 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/attempts \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "attempts": [
    {
      "ordinal": 0,
      "provider": "experiential_cloud",
      "lane": "platform",
      "state": "failed",
      "failure_class": "throttled",
      "error_message": null,
      "started_at": "2026-11-18T14:32:05.331Z",
      "terminal_at": "2026-11-18T14:32:05.902Z",
      "input_tokens": null,
      "cached_input_tokens": null,
      "output_tokens": null,
      "reasoning_tokens": null,
      "tool_names": []
    },
    {
      "ordinal": 1,
      "provider": "azure_openai",
      "lane": "platform",
      "state": "completed",
      "failure_class": null,
      "error_message": null,
      "started_at": "2026-11-18T14:32:05.910Z",
      "terminal_at": "2026-11-18T14:32:07.470Z",
      "input_tokens": 4210,
      "cached_input_tokens": 3584,
      "output_tokens": 388,
      "reasoning_tokens": 120,
      "tool_names": [
        "lookup_order"
      ]
    }
  ],
  "truncated": false
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/usage/requests/req_01JD8ZK4M2Q7V9X3N5T6B8C0EF/attempts