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.

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

クエリパラメータ

  • org_idstring必須

    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.

    デフォルト: 50

レスポンス

  • 200

    One page.

    レスポンス
    • org_idstring必須
    • eventsarray<object>必須
      events
      • request_idstring必須
      • api_key_idstring | null必須
      • user_idstring | null必須
      • aliasstring必須

        Model slug requested.

      • providerstring | null必須

        Provider that served it; masked house lanes read experiential_cloud.

      • laneenum必須

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

        "pass_through""platform_funded"null
      • input_tokensinteger必須
      • output_tokensinteger必須
      • cached_input_tokensinteger必須

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

      • reasoning_tokensinteger必須

        Part of output_tokens spent on reasoning.

      • cost_nano_usdinteger必須

        Charged to platform credits, integer nano-USD.

      • estimated_cost_nano_usdinteger必須

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

      • free_nano_usdinteger必須

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

      • latency_msinteger | null必須
      • statusenum必須
        "completed""failed""cancelled""incomplete""expired_before_dispatch""unknown_after_crash"
      • attempt_countinteger必須

        Provider dispatches; 0 = refused before dispatch.

      • daystring必須
      • created_atstring必須
    • next_cursorstring | null必須

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

  • 400

    Malformed date or cursor.

    レスポンス
    • 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).

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

リクエスト

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"

レスポンス

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