POST/api/orgs/{org_id}/spend/series

Read dimension series

Body is a frozen SpendQuery (with as_of). Returns seven spend-ranked leaders of group_by plus an exact remainder, per bucket. API keys need provisioning strength and scope: org.

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

パスパラメータ

  • org_idstring必須

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

リクエストボディ

  • startstring必須

    Inclusive start, with a UTC offset.

  • endstring必須

    Exclusive end, with a UTC offset. Must be after start.

  • time_zonestring

    IANA zone for day and month buckets.

    デフォルト: "UTC"
  • scopeany
    デフォルト: "org"
  • basisany
    デフォルト: "requests"
  • group_byany
    デフォルト: "model"
  • tag_keystring | null

    Required exactly when group_by is tag.

    デフォルト: null
  • grainany
    デフォルト: "day"
  • filtersarray<object>

    At most one filter per dimension.

    デフォルト: []
    filters
    • dimensionenum必須

      Grouping and filter dimension. key and member values are uuids. tag is only a group_by (with tag_key); filter tags through tags.

      "model""key""member""end_user""provider""funding""surface""outcome""error""app""prompt""tag""source"
    • valuesarray<string>
      デフォルト: []
    • missingboolean

      Also match calls with no value for this dimension.

      デフォルト: false
    • excludeboolean

      Invert the predicate. Must be a JSON boolean.

      デフォルト: false
  • tagsarray<object>

    At most one predicate per tag key.

    デフォルト: []
    tags
    • keystring必須
    • valuesarray<string>
      デフォルト: []
    • missingboolean

      Also match calls without this tag key.

      デフォルト: false
    • excludeboolean
      デフォルト: false
  • sortany
    デフォルト: "spend"
  • directionenum
    "asc""desc"
    デフォルト: "desc"
  • offsetinteger
    デフォルト: 0
  • limitinteger
    デフォルト: 50
  • as_ofstring | null

    Report cutoff. Server-set on the first read; not in the future and not before start.

    デフォルト: null
  • snapshot_idstring

    Registered snapshot token. Requires its original as_of. Omitted from responses when unset.

レスポンス

  • 200

    OK

    レスポンス
    • queryobject必須

      A bounded report slice. end is exclusive; the range is at most ten years. Omit as_of and snapshot_id for a fresh read; the response returns them frozen, and later reads (pagination, view, series, facets, activity, export) send them back unchanged so every panel reads one snapshot.

      query
      • startstring必須

        Inclusive start, with a UTC offset.

      • endstring必須

        Exclusive end, with a UTC offset. Must be after start.

      • time_zonestring

        IANA zone for day and month buckets.

        デフォルト: "UTC"
      • scopeany
        デフォルト: "org"
      • basisany
        デフォルト: "requests"
      • group_byany
        デフォルト: "model"
      • tag_keystring | null

        Required exactly when group_by is tag.

        デフォルト: null
      • grainany
        デフォルト: "day"
      • filtersarray<object>

        At most one filter per dimension.

        デフォルト: []
        filters
        • dimensionenum必須

          Grouping and filter dimension. key and member values are uuids. tag is only a group_by (with tag_key); filter tags through tags.

          "model""key""member""end_user""provider""funding""surface""outcome""error""app""prompt""tag""source"
        • valuesarray<string>
          デフォルト: []
        • missingboolean

          Also match calls with no value for this dimension.

          デフォルト: false
        • excludeboolean

          Invert the predicate. Must be a JSON boolean.

          デフォルト: false
      • tagsarray<object>

        At most one predicate per tag key.

        デフォルト: []
        tags
        • keystring必須
        • valuesarray<string>
          デフォルト: []
        • missingboolean

          Also match calls without this tag key.

          デフォルト: false
        • excludeboolean
          デフォルト: false
      • sortany
        デフォルト: "spend"
      • directionenum
        "asc""desc"
        デフォルト: "desc"
      • offsetinteger
        デフォルト: 0
      • limitinteger
        デフォルト: 50
      • as_ofstring | null

        Report cutoff. Server-set on the first read; not in the future and not before start.

        デフォルト: null
      • snapshot_idstring

        Registered snapshot token. Requires its original as_of. Omitted from responses when unset.

    • coverageobject必須

      Projection freshness, independent of whether the slice is empty.

      coverage
      • as_ofstring必須
      • projected_throughstring | null必須
      • completeboolean必須
      • pending_requestsinteger必須
      • includes_pre_admission_rejectionsboolean
        デフォルト: false
    • totalsobject必須

      Exact counters and money legs for one basis. The all-in spend is paid + BYOK + free.

      totals
      • countinteger必須

        Settled requests (or terminal attempts on the attempts basis); not a success count.

      • rejected_countinteger必須

        Failed or expired requests with no provider dispatch (always 0 on the attempts basis).

      • errorsinteger必須

        Non-completed requests or attempts, rejections included.

      • input_tokensinteger必須
      • output_tokensinteger必須
      • cached_input_tokensinteger必須
      • reasoning_tokensinteger必須
      • paid_nano_usdstring必須

        Charged credits. Integer nano-USD as a decimal string (1 USD = 1,000,000,000) so JavaScript cannot round it.

      • byok_nano_usdstring必須

        Bring-your-own-key list estimate; never charged. Integer nano-USD as a decimal string (1 USD = 1,000,000,000) so JavaScript cannot round it.

      • free_nano_usdstring必須

        Free promotional usage at list value; not a credit debit. Integer nano-USD as a decimal string (1 USD = 1,000,000,000) so JavaScript cannot round it.

      • unknown_usage_countinteger必須

        Usage whose provider accounting is unknown. Nonzero makes the money provisional.

    • bucketsarray<object>必須
      buckets
      • startstring必須
      • figuresobject必須

        Exact counters and money legs for one basis. The all-in spend is paid + BYOK + free.

        figures
        • countinteger必須

          Settled requests (or terminal attempts on the attempts basis); not a success count.

        • rejected_countinteger必須

          Failed or expired requests with no provider dispatch (always 0 on the attempts basis).

        • errorsinteger必須

          Non-completed requests or attempts, rejections included.

        • input_tokensinteger必須
        • output_tokensinteger必須
        • cached_input_tokensinteger必須
        • reasoning_tokensinteger必須
        • paid_nano_usdstring必須

          Charged credits. Integer nano-USD as a decimal string (1 USD = 1,000,000,000) so JavaScript cannot round it.

        • byok_nano_usdstring必須

          Bring-your-own-key list estimate; never charged. Integer nano-USD as a decimal string (1 USD = 1,000,000,000) so JavaScript cannot round it.

        • free_nano_usdstring必須

          Free promotional usage at list value; not a credit debit. Integer nano-USD as a decimal string (1 USD = 1,000,000,000) so JavaScript cannot round it.

        • unknown_usage_countinteger必須

          Usage whose provider accounting is unknown. Nonzero makes the money provisional.

    • seriesarray<object>必須
      series
      • valuestring | null必須
      • labelstring必須
      • otherboolean必須
      • figuresobject必須

        Exact counters and money legs for one basis. The all-in spend is paid + BYOK + free.

        figures
        • countinteger必須

          Settled requests (or terminal attempts on the attempts basis); not a success count.

        • rejected_countinteger必須

          Failed or expired requests with no provider dispatch (always 0 on the attempts basis).

        • errorsinteger必須

          Non-completed requests or attempts, rejections included.

        • input_tokensinteger必須
        • output_tokensinteger必須
        • cached_input_tokensinteger必須
        • reasoning_tokensinteger必須
        • paid_nano_usdstring必須

          Charged credits. Integer nano-USD as a decimal string (1 USD = 1,000,000,000) so JavaScript cannot round it.

        • byok_nano_usdstring必須

          Bring-your-own-key list estimate; never charged. Integer nano-USD as a decimal string (1 USD = 1,000,000,000) so JavaScript cannot round it.

        • free_nano_usdstring必須

          Free promotional usage at list value; not a credit debit. Integer nano-USD as a decimal string (1 USD = 1,000,000,000) so JavaScript cannot round it.

        • unknown_usage_countinteger必須

          Usage whose provider accounting is unknown. Nonzero makes the money provisional.

      • cellsarray<object>必須
        cells
        • countinteger必須

          Settled requests (or terminal attempts on the attempts basis); not a success count.

        • rejected_countinteger必須

          Failed or expired requests with no provider dispatch (always 0 on the attempts basis).

        • errorsinteger必須

          Non-completed requests or attempts, rejections included.

        • input_tokensinteger必須
        • output_tokensinteger必須
        • cached_input_tokensinteger必須
        • reasoning_tokensinteger必須
        • paid_nano_usdstring必須

          Charged credits. Integer nano-USD as a decimal string (1 USD = 1,000,000,000) so JavaScript cannot round it.

        • byok_nano_usdstring必須

          Bring-your-own-key list estimate; never charged. Integer nano-USD as a decimal string (1 USD = 1,000,000,000) so JavaScript cannot round it.

        • free_nano_usdstring必須

          Free promotional usage at list value; not a credit debit. Integer nano-USD as a decimal string (1 USD = 1,000,000,000) so JavaScript cannot round it.

        • unknown_usage_countinteger必須

          Usage whose provider accounting is unknown. Nonzero makes the money provisional.

      • kindenum必須

        value an observed value, missing unattributed calls, other the non-selectable remainder.

        "value""missing""other"
  • 400

    Invalid Spend query, or the query lacks the frozen snapshot this route requires.

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

  • 403

    The key is not a provisioning key (inference keys are refused on every Spend route, reads included), or it is a customer-plan 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

    The org is not the key's own organization (always 404, never 403).

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

  • 409

    The snapshot (as_of + snapshot_id) expired (24 hours) or was invalidated. Refresh and replace every projection together.

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

  • 422

    Body failed schema validation ({detail:[...]}), or the report exceeds a work bound (report_too_large, series_too_large, export_too_large).

  • 503

    Reporting is unavailable, initializing, or the bounded read timed out. Not empty data; retry or narrow the range.

    レスポンス
    • 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 -X POST https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/spend/series \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "start": "2026-11-01T00:00:00Z",
  "end": "2026-11-08T00:00:00Z",
  "time_zone": "UTC",
  "scope": "org",
  "basis": "requests",
  "group_by": "model",
  "grain": "day",
  "filters": [],
  "tags": [],
  "sort": "spend",
  "direction": "desc",
  "offset": 0,
  "limit": 7,
  "as_of": "2026-11-19T14:02:11.418Z",
  "snapshot_id": "c1e7a4d2-5b3f-4e8a-9d61-2f0b7c3a9e45"
}'

レスポンス

{
  "query": {
    "start": "2026-11-01T00:00:00Z",
    "end": "2026-11-08T00:00:00Z",
    "time_zone": "UTC",
    "scope": "org",
    "basis": "requests",
    "group_by": "model",
    "grain": "day",
    "filters": [],
    "tags": [],
    "sort": "spend",
    "direction": "desc",
    "offset": 0,
    "limit": 7,
    "tag_key": null,
    "as_of": "2026-11-19T14:02:11.418Z",
    "snapshot_id": "c1e7a4d2-5b3f-4e8a-9d61-2f0b7c3a9e45"
  },
  "coverage": {
    "as_of": "2026-11-19T14:02:11.418Z",
    "projected_through": "2026-11-08T00:00:00Z",
    "complete": true,
    "pending_requests": 0,
    "includes_pre_admission_rejections": false
  },
  "totals": {
    "count": 18420,
    "rejected_count": 37,
    "errors": 212,
    "input_tokens": 96214000,
    "output_tokens": 8120400,
    "cached_input_tokens": 51200000,
    "reasoning_tokens": 1840000,
    "paid_nano_usd": "41382500000",
    "byok_nano_usd": "6120000000",
    "free_nano_usd": "850000000",
    "unknown_usage_count": 0
  },
  "buckets": [
    {
      "start": "2026-11-01T00:00:00Z",
      "figures": {
        "count": 2610,
        "rejected_count": 5,
        "errors": 30,
        "input_tokens": 13700000,
        "output_tokens": 1160000,
        "cached_input_tokens": 7300000,
        "reasoning_tokens": 262000,
        "paid_nano_usd": "5921000000",
        "byok_nano_usd": "870000000",
        "free_nano_usd": "120000000",
        "unknown_usage_count": 0
      }
    }
  ],
  "series": [
    {
      "value": "gpt-6-luna",
      "label": "gpt-6-luna",
      "other": false,
      "kind": "value",
      "figures": {
        "count": 11030,
        "rejected_count": 20,
        "errors": 101,
        "input_tokens": 61200000,
        "output_tokens": 5102000,
        "cached_input_tokens": 38100000,
        "reasoning_tokens": 1840000,
        "paid_nano_usd": "29880000000",
        "byok_nano_usd": "0",
        "free_nano_usd": "0",
        "unknown_usage_count": 0
      },
      "cells": [
        {
          "count": 2610,
          "rejected_count": 5,
          "errors": 30,
          "input_tokens": 13700000,
          "output_tokens": 1160000,
          "cached_input_tokens": 7300000,
          "reasoning_tokens": 262000,
          "paid_nano_usd": "5921000000",
          "byok_nano_usd": "870000000",
          "free_nano_usd": "120000000",
          "unknown_usage_count": 0
        }
      ]
    }
  ]
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/spend/series