/api/orgs/{org_id}/usage/timeseriesGet bucketed usage over a window
Per (bucket, model, lane) cells; every filter composes. request_count includes errors and pre-dispatch refusals. API-key reads share the per-organization request-log read limit.
認証: AuthorizationヘッダーにBearer形式のAPIキー
パスパラメータ
org_idstring必須Your organization id (uuid).
GET /api/whoamireturns it.
クエリパラメータ
windowenumLookback window ending now.
24hbuckets hourly,7dand30ddaily.modelstringRestrict to one model slug (the alias the caller requested).
api_key_idstringRestrict to one API key (uuid).
laneenumRestrict to one money lane:
platform(platform credits) orbyok(your own provider key, never charged). A lane cut excludes requests where nothing was dispatched.comparebooleanAdd
previous: totals of the period of the same length just before the window.
レスポンス
200Buckets.
レスポンス
windowenum必須bucket_secondsinteger必須3600 for
24h, 86400 otherwise.bucketsarray<object>必須buckets
bucket_startstring必須modelstring必須laneenum必須Null when nothing was dispatched for the cell's requests.
request_countinteger必須Every finished request, errors and pre-dispatch refusals included.
error_countinteger必須Subset whose terminal state was not
completed.input_tokensinteger必須output_tokensinteger必須cached_input_tokensinteger必須Subset of
input_tokensread from the provider cache.cost_usdnumber必須Charged platform credits, dollars.
estimated_cost_usdnumber必須Never-charged BYOK estimate at list price, dollars.
free_usdnumber必須List-price value of promotion-funded usage, dollars (never charged).
previousobject | nullPresent only with
compare=true.いずれか
object
request_countinteger必須Every finished request, errors and pre-dispatch refusals included.
error_countinteger必須Subset whose terminal state was not
completed.input_tokensinteger必須output_tokensinteger必須cached_input_tokensinteger必須cost_usdnumber必須Charged platform credits, dollars.
estimated_cost_usdnumber必須Never-charged BYOK estimate at list price, dollars.
free_usdnumber必須List-price value of promotion-funded usage, dollars (never charged).
400Unknown window or lane, or a malformed
api_key_id.レスポンス
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).
404Unknown organization, or not the key's own organization.
レスポンス
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).
429Too many reads.
rate_limited: this organization's API-key reads of the request log are over about 10 per second (burst 30) or 4 in flight on one server (sessions are not limited).build_capacity: the shared analytics read slots are busy. Retry afterRetry-After.レスポンス
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).
503Usage analytics are temporarily unavailable. Retry shortly.
レスポンス
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 https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/usage/timeseries?window=24h&model=gpt-6-luna&api_key_id=6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33&lane=platform&compare=true \
-H "Authorization: Bearer YOUR_API_KEY"レスポンス
{
"window": "24h",
"bucket_seconds": 3600,
"buckets": [
{
"bucket_start": "2026-11-18T14:00:00Z",
"model": "gpt-6-luna",
"lane": "platform",
"request_count": 212,
"error_count": 3,
"input_tokens": 880412,
"output_tokens": 61220,
"cached_input_tokens": 702100,
"cost_usd": 0.412,
"estimated_cost_usd": 0,
"free_usd": 0
}
],
"previous": {
"request_count": 4980,
"error_count": 41,
"input_tokens": 20114200,
"output_tokens": 1402200,
"cached_input_tokens": 15800400,
"cost_usd": 9.88,
"estimated_cost_usd": 1.2,
"free_usd": 0.4
}
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/usage/timeseries?window=24h&model=gpt-6-luna&api_key_id=6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33&lane=platform&compare=true