/api/orgs/{org_id}/spend/activityList Spend activity
Request-level (or attempt-level) rows under the report's full filter set, keyset paged by next_cursor. Metadata only, no captured bodies. With include_features: true the response is the source-discriminated page. API keys need provisioning strength and scope: org.
認証: AuthorizationヘッダーにBearer形式のAPIキー
パスパラメータ
org_idstring必須Your organization id (uuid).
GET /api/whoamireturns it.
リクエストボディ
queryobject必須A bounded report slice.
endis exclusive; the range is at most ten years. Omitas_ofandsnapshot_idfor 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_zonestringIANA zone for day and month buckets.
scopeanybasisanygroup_byanytag_keystring | nullRequired exactly when
group_byistag.grainanyfiltersarray<object>At most one filter per dimension.
filters
dimensionenum必須Grouping and filter dimension.
keyandmembervalues are uuids.tagis only agroup_by(withtag_key); filter tags throughtags.valuesarray<string>missingbooleanAlso match calls with no value for this dimension.
excludebooleanInvert the predicate. Must be a JSON boolean.
tagsarray<object>At most one predicate per tag key.
tags
keystring必須valuesarray<string>missingbooleanAlso match calls without this tag key.
excludeboolean
sortanydirectionenumoffsetintegerlimitintegeras_ofstring | nullReport cutoff. Server-set on the first read; not in the future and not before
start.snapshot_idstringRegistered snapshot token. Requires its original
as_of. Omitted from responses when unset.
cursorobject | nullいずれか
object
timestring必須idstring必須
errors_onlybooleaninclude_featuresbooleanAlso return feature debits (usage intelligence reports) as
source: intelligencerows; every row then carriessource.
レスポンス
200OK
400Invalid Spend query, or the query lacks the frozen snapshot this route requires.
レスポンス
errorstring必須Human-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
401Missing, unknown or revoked API key.
レスポンス
errorstring必須Human-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
403The 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.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
404The org is not the key's own organization (always 404, never 403).
レスポンス
errorstring必須Human-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
409The snapshot (
as_of+snapshot_id) expired (24 hours) or was invalidated. Refresh and replace every projection together.レスポンス
errorstring必須Human-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
422Body failed schema validation (
{detail:[...]}), or the report exceeds a work bound (report_too_large,series_too_large,export_too_large).503Reporting is unavailable, initializing, or the bounded read timed out. Not empty data; retry or narrow the range.
レスポンス
errorstring必須Human-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-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/activity \
-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,
"as_of": "2026-11-19T14:02:11.418Z",
"snapshot_id": "c1e7a4d2-5b3f-4e8a-9d61-2f0b7c3a9e45"
},
"cursor": null,
"errors_only": false,
"include_features": false
}'レスポンス
{
"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"
},
"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
},
"rows": [
{
"id": "req_01JDX4K9T2V7",
"request_id": "req_01JDX4K9T2V7",
"created_at": "2026-11-03T09:41:07.212Z",
"dimensions": {
"model": "gpt-6-luna",
"key": "9b1e3f20-6a4c-4d8e-a2f7-0c5d8e1b3a64",
"provider": "openai",
"funding": "platform_funded",
"surface": "chat",
"outcome": "completed"
},
"tags": {
"team": "search"
},
"figures": {
"count": 1,
"rejected_count": 0,
"errors": 0,
"input_tokens": 5120,
"output_tokens": 418,
"cached_input_tokens": 4096,
"reasoning_tokens": 0,
"paid_nano_usd": "2710000",
"byok_nano_usd": "0",
"free_nano_usd": "0",
"unknown_usage_count": 0
},
"detail": {
"model": "gpt-6-luna",
"provider": "openai",
"lane": "platform_funded",
"api_key_id": "9b1e3f20-6a4c-4d8e-a2f7-0c5d8e1b3a64",
"key_label": "Acme backend",
"status": "completed",
"attempt_count": 1,
"pricing_known": true,
"latency_ms": 2140,
"ttft_ms": 388,
"tools_used": [],
"failure_class": null,
"error_message": null,
"prompt_group": "4f1c9a2e7b30",
"conversation_group": null,
"attribution_label": null,
"usage_evidence": {
"usage_source": "observed",
"input_tokens": 5120,
"output_tokens": 418,
"cached_input_tokens": 4096,
"reasoning_tokens": 0,
"no_dispatch": false,
"cache_write_input_tokens": 0
}
}
}
],
"next_cursor": {
"time": "2026-11-03T09:41:07.212Z",
"id": "req_01JDX4K9T2V7"
}
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/spend/activity