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

Export Spend as CSV

Body is a SpendQuery directly. One complete grouped aggregation (at most 10,000 groups and 16 MiB), returned as text/csv, not JSON. Spend columns are dollars; only paid_usd is charged credits. 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

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

Responses

  • 200

    Complete grouped CSV (not request-level rows): exact dollar columns with 9 decimals, the accepted query, cutoff and measure definitions. Served as an attachment spend.csv, Cache-Control: private, no-store.

  • 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, or the export exceeds 10,000 groups or 16 MiB.

  • 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/export \
  -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": 50
}'

Response

"group","label","basis","count","rejected_count","errors","input_tokens","output_tokens","cached_input_tokens","reasoning_tokens","spend_usd","paid_usd","byok_estimated_usd","free_list_value_usd","unknown_usage_count","from","to_exclusive","time_zone","as_of","query","row_kind","group_by","tag_key","projected_through","count_definition","errors_definition","rejected_count_definition","prompt_group_definition","spend_definition"
"gpt-6-luna","gpt-6-luna","requests","11030","20","101","61200000","5102000","38100000","1840000","29.880000000","29.880000000","0.000000000","0.000000000","0","2026-11-01T00:00:00+00:00","2026-11-08T00:00:00+00:00","UTC","2026-11-19T14:02:11.418000+00:00","{...}","aggregate_group","model","","2026-11-08T00:00:00+00:00","Settled customer requests; not a successful-completion count","Non-completed requests: status != completed; rejections are included","Subset with zero attempts and status failed or expired_before_dispatch; cancellations are not rejections","SHA-256 of system/developer content and tool declarations; not full payload, request or session; label shows 12 characters","paid_usd + byok_estimated_usd + free_list_value_usd; only paid_usd is charged credits; excludes pending holds"

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