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

Get bucketed usage over a window

Per (bucket, model, lane) cells; every filter composes. request_count includes errors and pre-dispatch refusals. API-key reads share the per-organization request-log read limit.

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

パスパラメータ

  • org_idstring必須

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

クエリパラメータ

  • windowenum

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

    "24h""7d""30d"
    デフォルト: "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"
  • compareboolean

    Add previous: totals of the period of the same length just before the window.

    デフォルト: false

レスポンス

  • 200

    Buckets.

    レスポンス
    • windowenum必須
      "24h""7d""30d"
    • bucket_secondsinteger必須

      3600 for 24h, 86400 otherwise.

    • bucketsarray<object>必須
      buckets
      • bucket_startstring必須
      • modelstring必須
      • laneenum必須

        Null when nothing was dispatched for the cell's requests.

        "platform""byok"null
      • request_countinteger必須

        Every finished request, errors and pre-dispatch refusals included.

      • error_countinteger必須

        Subset whose terminal state was not completed.

      • input_tokensinteger必須
      • output_tokensinteger必須
      • cached_input_tokensinteger必須

        Subset of input_tokens read from the provider cache.

      • cost_usdnumber必須

        Charged platform credits, dollars.

      • estimated_cost_usdnumber必須

        Never-charged BYOK estimate at list price, dollars.

      • free_usdnumber必須

        List-price value of promotion-funded usage, dollars (never charged).

    • previousobject | null

      Present only with compare=true.

      いずれか

      object

      • request_countinteger必須

        Every finished request, errors and pre-dispatch refusals included.

      • error_countinteger必須

        Subset whose terminal state was not completed.

      • input_tokensinteger必須
      • output_tokensinteger必須
      • cached_input_tokensinteger必須
      • cost_usdnumber必須

        Charged platform credits, dollars.

      • estimated_cost_usdnumber必須

        Never-charged BYOK estimate at list price, dollars.

      • free_usdnumber必須

        List-price value of promotion-funded usage, dollars (never charged).

  • 400

    Unknown window or lane, or a malformed api_key_id.

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

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

  • 503

    Usage analytics are temporarily unavailable. Retry shortly.

    レスポンス
    • 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/timeseries?window=24h&model=gpt-6-luna&api_key_id=6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33&lane=platform&compare=true \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンス

{
  "window": "24h",
  "bucket_seconds": 3600,
  "buckets": [
    {
      "bucket_start": "2026-11-18T14:00:00Z",
      "model": "gpt-6-luna",
      "lane": "platform",
      "request_count": 212,
      "error_count": 3,
      "input_tokens": 880412,
      "output_tokens": 61220,
      "cached_input_tokens": 702100,
      "cost_usd": 0.412,
      "estimated_cost_usd": 0,
      "free_usd": 0
    }
  ],
  "previous": {
    "request_count": 4980,
    "error_count": 41,
    "input_tokens": 20114200,
    "output_tokens": 1402200,
    "cached_input_tokens": 15800400,
    "cost_usd": 9.88,
    "estimated_cost_usd": 1.2,
    "free_usd": 0.4
  }
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/usage/timeseries?window=24h&model=gpt-6-luna&api_key_id=6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33&lane=platform&compare=true