GET/api/orgs/{org_id}/spend/analytics/{analysis_id}

Poll a Spend analytics load

Resumes the same load, rechecking authority. Same envelope as the POST; keep the original id. API keys need provisioning strength.

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

パスパラメータ

  • org_idstring必須

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

  • analysis_idstring必須

    Analytics load id returned by POST /spend/analytics.

クエリパラメータ

  • sortany

    Sort measure for the groups.

    デフォルト: "spend"
  • directionenum

    Sort direction.

    "asc""desc"
    デフォルト: "desc"
  • offsetinteger

    Group offset.

    デフォルト: 0
  • limitinteger

    Groups per page.

    デフォルト: 50
  • comparisonenum

    Include the previous-period comparison (send it on every poll if you started with it).

    "previous_elapsed"

レスポンス

  • 200

    OK

    レスポンス
    • idstring | null必須
    • statusenum必須
      "loading""ready""failed"
    • reportobject | null必須
      いずれか

      object

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

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

      • groupsarray<object>必須
        groups
        • valuestring | null必須
        • labelstring | null必須
        • 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.

      • filter_labelsarray<object>
        デフォルト: []
        filter_labels
        • valuestring | null必須
        • labelstring必須
        • 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"
        • tag_keystring | null
          デフォルト: null
      • group_countinteger必須
      • next_offsetinteger | null

        Null on the last page.

      • coverageobject必須

        Projection freshness, independent of whether the slice is empty.

        coverage
        • as_ofstring必須
        • projected_throughstring | null必須
        • completeboolean必須
        • pending_requestsinteger必須
        • includes_pre_admission_rejectionsboolean
          デフォルト: false
    • buildobject | null必須
      いずれか

      object

      • idstring必須
      • statusenum必須

        Currently returned: running, completed, failed or expired.

        "queued""running""completed""failed""cancelled""expired"
      • 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.

      • created_atstring必須
      • updated_atstring必須
      • expires_atstring必須
      • progressobject必須

        Committed checkpoint counters, not a percent complete.

        progress
        • processed_factsinteger必須
        • processed_sourcesinteger必須
        • phaseenum必須
          "coverage""aggregate""publish"
      • error_codestring | null必須
    • error_codestring | null必須
    • comparisonobject

      Previous elapsed period, ending at the primary query.start. Totals exist only when ready; never substitute zero.

      comparison
      • kindany必須
      • derivationany必須
      • statusenum必須
        "pending""ready""unavailable"
      • reasonenum必須
        "not_prepared""coverage""capacity""deadline""cancelled""invalidated""error"null
      • startstring | null必須
      • endstring | null必須
      • as_ofstring | null必須
      • projected_throughstring | null必須
      • totalsobject | null必須
        いずれか

        object

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

    • seriesany

      Companion: model stacks at the report's snapshot. Absent when not asked for or when its read failed.

      series
      • 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"
    • peopleany

      Companion: rail grouped by companions.people.

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

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

      • groupsarray<object>必須
        groups
        • valuestring | null必須
        • labelstring | null必須
        • 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.

      • filter_labelsarray<object>
        デフォルト: []
        filter_labels
        • valuestring | null必須
        • labelstring必須
        • 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"
        • tag_keystring | null
          デフォルト: null
      • group_countinteger必須
      • next_offsetinteger | null

        Null on the last page.

      • coverageobject必須

        Projection freshness, independent of whether the slice is empty.

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

      Companion: latency for companions.latency.

      latency
      • windowstring必須
      • measured_fromstring必須
      • requestsinteger必須
      • latencyobject | null必須
        いずれか

        object

        • samplesinteger必須
        • p50_msinteger必須
        • p95_msinteger必須
      • ttftobject | null必須
        いずれか

        object

        • samplesinteger必須
        • p50_msinteger必須
        • p95_msinteger必須
  • 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

    Unknown handle, or the org is 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).

  • 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

    Query parameters failed validation, or the result exceeds a work bound.

  • 429

    Analytics acquisition is at capacity. Carries Retry-After: 1.

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

    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 https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/spend/analytics/5a9e2b71-0c4d-4f6e-8a13-7d2b9c0e4f58?sort=spend&direction=desc&offset=0&limit=50&comparison=previous_elapsed \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンス

{
  "id": "5a9e2b71-0c4d-4f6e-8a13-7d2b9c0e4f58",
  "status": "ready",
  "report": {
    "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": 50,
      "tag_key": null,
      "as_of": "2026-11-19T14:02:11.418Z",
      "snapshot_id": "c1e7a4d2-5b3f-4e8a-9d61-2f0b7c3a9e45"
    },
    "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
        }
      }
    ],
    "groups": [
      {
        "value": "gpt-6-luna",
        "label": "gpt-6-luna",
        "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
        }
      },
      {
        "value": "claude-fable-5.1",
        "label": "claude-fable-5.1",
        "figures": {
          "count": 7390,
          "rejected_count": 17,
          "errors": 111,
          "input_tokens": 35014000,
          "output_tokens": 3018400,
          "cached_input_tokens": 13100000,
          "reasoning_tokens": 0,
          "paid_nano_usd": "11502500000",
          "byok_nano_usd": "6120000000",
          "free_nano_usd": "850000000",
          "unknown_usage_count": 0
        }
      }
    ],
    "filter_labels": [],
    "group_count": 2,
    "next_offset": null,
    "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
    }
  },
  "build": null,
  "error_code": null,
  "comparison": {
    "kind": "previous_elapsed",
    "derivation": "milliseconds_v1",
    "status": "ready",
    "reason": null,
    "start": "2026-10-25T00:00:00Z",
    "end": "2026-11-01T00:00:00Z",
    "as_of": "2026-11-19T14:02:11.418Z",
    "projected_through": "2026-11-08T00:00:00Z",
    "totals": {
      "count": 16210,
      "rejected_count": 29,
      "errors": 190,
      "input_tokens": 88100000,
      "output_tokens": 7200000,
      "cached_input_tokens": 46000000,
      "reasoning_tokens": 1500000,
      "paid_nano_usd": "37904000000",
      "byok_nano_usd": "5100000000",
      "free_nano_usd": "0",
      "unknown_usage_count": 0
    }
  }
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/spend/analytics/5a9e2b71-0c4d-4f6e-8a13-7d2b9c0e4f58?sort=spend&direction=desc&offset=0&limit=50&comparison=previous_elapsed