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

Read the latest completed report

Reads an already completed result for an unpinned query without starting work. Returns {build, report}, or with comparison a ready analytics envelope; null when nothing is ready (a request error is not a miss). API keys need provisioning strength and scope: org.

Authentication: Bearer API key in the Authorization header

Path parameters

  • org_idstringrequired

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

Request body

  • queryanyrequired

    Unpinned: no as_of or snapshot_id.

    query
    • startstringrequired

      Inclusive start, with a UTC offset.

    • endstringrequired

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

    • time_zonestring

      IANA zone for day and month buckets.

      Default: "UTC"
    • scopeany
      Default: "org"
    • basisany
      Default: "requests"
    • group_byany
      Default: "model"
    • tag_keystring | null

      Required exactly when group_by is tag.

      Default: null
    • grainany
      Default: "day"
    • filtersarray<object>

      At most one filter per dimension.

      Default: []
      filters
      • dimensionenumrequired

        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>
        Default: []
      • missingboolean

        Also match calls with no value for this dimension.

        Default: false
      • excludeboolean

        Invert the predicate. Must be a JSON boolean.

        Default: false
    • tagsarray<object>

      At most one predicate per tag key.

      Default: []
      tags
      • keystringrequired
      • valuesarray<string>
        Default: []
      • missingboolean

        Also match calls without this tag key.

        Default: false
      • excludeboolean
        Default: false
    • sortany
      Default: "spend"
    • directionenum
      "asc""desc"
      Default: "desc"
    • offsetinteger
      Default: 0
    • limitinteger
      Default: 50
    • as_ofstring | null

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

      Default: null
    • snapshot_idstring

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

  • comparisonenum

    Return a ready analytics envelope with the previous-period comparison.

    "previous_elapsed"

Responses

  • 200

    The latest completed result, or null.

  • 400

    Invalid Spend query (bad filter value, a future as_of, a personal scope: self from a key, or a missing snapshot where one is required).

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

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

    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

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

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

  • 409

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

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

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

    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 -X POST https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/spend/latest \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "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
  }
}'

Response

{
  "build": {
    "id": "8d2f1c6a-3e4b-4a7d-b9e0-5c1f2a7d8e30",
    "status": "completed",
    "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"
    },
    "created_at": "2026-11-19T14:02:11.420Z",
    "updated_at": "2026-11-19T14:02:12.031Z",
    "expires_at": "2026-11-20T14:02:11.420Z",
    "progress": {
      "processed_facts": 18420,
      "processed_sources": 1,
      "phase": "publish"
    },
    "error_code": null
  },
  "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
    }
  }
}

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