GET/api/gateway/usage/events

List settled usage events

Keyset pages of settled requests, newest first. Pass next_cursor back as cursor. Money is integer nano-USD.

Authentication: Bearer API key in the Authorization header

Query parameters

  • org_idstringrequired

    Your organization id. Required (this route takes it as a query parameter).

  • api_key_idstring

    Restrict to one API key.

  • fromstring

    First day, inclusive (YYYY-MM-DD).

  • tostring

    Last day, inclusive (YYYY-MM-DD).

  • cursorstring

    Opaque cursor from the previous page.

  • limitinteger

    Page size, clamped to 1..200.

    Default: 50

Responses

  • 200

    One page.

    Response
    • org_idstringrequired
    • eventsarray<object>required
      events
      • request_idstringrequired
      • api_key_idstring | nullrequired
      • user_idstring | nullrequired
      • aliasstringrequired

        Model slug requested.

      • providerstring | nullrequired

        Provider that served it; masked house lanes read experiential_cloud.

      • laneenumrequired

        platform_funded = platform credits; pass_through = your own provider key. Null when nothing was dispatched.

        "pass_through""platform_funded"null
      • input_tokensintegerrequired
      • output_tokensintegerrequired
      • cached_input_tokensintegerrequired

        Part of input_tokens served from the provider's prompt cache.

      • reasoning_tokensintegerrequired

        Part of output_tokens spent on reasoning.

      • cost_nano_usdintegerrequired

        Charged to platform credits, integer nano-USD.

      • estimated_cost_nano_usdintegerrequired

        Never-charged estimate for BYOK traffic at list price, integer nano-USD.

      • free_nano_usdintegerrequired

        List-price value of the promotion-funded portion, integer nano-USD (both cost columns are 0 for it).

      • latency_msinteger | nullrequired
      • statusenumrequired
        "completed""failed""cancelled""incomplete""expired_before_dispatch""unknown_after_crash"
      • attempt_countintegerrequired

        Provider dispatches; 0 = refused before dispatch.

      • daystringrequired
      • created_atstringrequired
    • next_cursorstring | nullrequired

      Opaque. Pass back as cursor for the next page; null when this page ended the stream.

  • 400

    Malformed date or cursor.

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

Request

curl https://api.experientiallabs.ai/api/gateway/usage/events?org_id=3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10&api_key_id=6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33&from=2026-11-17&to=2026-11-18&cursor=MjAyNi0xMS0xOHwyMDI2LTExLTE4VDE0OjMyOjA3LjQ4MVp8cmVxXzAxSkQ4Wks0&limit=100 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "org_id": "3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10",
  "events": [
    {
      "request_id": "req_01JD8ZK4M2Q7V9X3N5T6B8C0EF",
      "api_key_id": "6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33",
      "user_id": null,
      "alias": "gpt-6-luna",
      "provider": "experiential_cloud",
      "lane": "platform_funded",
      "input_tokens": 4210,
      "output_tokens": 388,
      "cached_input_tokens": 3584,
      "reasoning_tokens": 120,
      "cost_nano_usd": 1284000,
      "estimated_cost_nano_usd": 0,
      "free_nano_usd": 0,
      "latency_ms": 2140,
      "status": "completed",
      "attempt_count": 1,
      "day": "2026-11-18",
      "created_at": "2026-11-18T14:32:07.481Z"
    }
  ],
  "next_cursor": null
}

https://api.experientiallabs.ai/api/gateway/usage/events?org_id=3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10&api_key_id=6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33&from=2026-11-17&to=2026-11-18&cursor=MjAyNi0xMS0xOHwyMDI2LTExLTE4VDE0OjMyOjA3LjQ4MVp8cmVxXzAxSkQ4Wks0&limit=100