/api/v1/usagePage through settled requests with cost and attribution
Keyset-paginated feed of settled requests, newest first, for rebilling end customers. Filter by attribution_label (the safety_identifier/user you sent) for one end customer. While a full page returns, echo next_cursor's three fields back as cursor_ts, cursor_id, cursor_after.
Authentication: Bearer API key in the Authorization header
Query parameters
windowenumLookback window. Default
7d.modelstringOnly requests to this model slug.
api_key_idstringOnly requests made with this key id (uuid).
statusenumTerminal status, or
errorfor every status other thancompleted.attribution_labelstringOnly requests carrying this end-customer label.
cursor_tsstringFrom
next_cursor.cursor_ts. Pass withcursor_id.cursor_idstringFrom
next_cursor.cursor_id. Pass withcursor_ts.cursor_afterstringFrom
next_cursor.cursor_after; freezes the window's lower bound across pages.limitintegerPage size, 1 to 200.
Responses
200One page of settled requests.
Response
dataarray<object>requireddata
idstringRequest id.
created_atstringmodelstringproviderstring | nullattribution_labelstring | nullThe
safety_identifieroruseryou sent; null when neither.real_cost_usdnumberCharged credits plus attributed own-key estimate, USD. 0 with pricing_known false means unpriced, not free.
cost_usdnumberCharged, USD.
estimated_cost_usdnumberOwn-key list estimate, USD.
pricing_knownbooleaninput_tokensintegeroutput_tokensintegercached_input_tokensintegerreasoning_tokensintegerstatusenumapi_key_idstring | null
next_cursorobject | nullrequiredPresent while a full page came back; null on the last page.
One of
object
cursor_tsstringrequiredcursor_idstringrequiredcursor_afterstringrequired
400Unknown window or status, malformed key id, or a half-supplied cursor.
Response
errorstringrequiredHuman-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.
Response
errorstringrequiredHuman-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 resource does not exist or belongs to another organization.
Response
errorstringrequiredHuman-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).
422limitoutside 1 to 200.Response
errorstringrequiredHuman-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).
Request
curl https://api.experientiallabs.ai/api/v1/usage?window=30d&model=claude-opus-5.5&api_key_id=0b9d4f6e-2a1c-4e8b-9f37-5c6d2e1a8b40&status=completed&attribution_label=customer-4821&cursor_ts=2026-11-18T21%3A04%3A11.392Z&cursor_id=req_3a9e1f0c7b2d4c58a6e1d9f4b0c2a817&cursor_after=2026-10-20T21%3A04%3A00%2B00%3A00&limit=100 \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"data": [
{
"id": "req_3a9e1f0c7b2d4c58a6e1d9f4b0c2a817",
"created_at": "2026-11-18T21:04:11.392Z",
"model": "claude-opus-5.5",
"provider": "anthropic",
"attribution_label": "customer-4821",
"real_cost_usd": 0.004215,
"cost_usd": 0.004215,
"estimated_cost_usd": 0,
"pricing_known": true,
"input_tokens": 1840,
"output_tokens": 402,
"cached_input_tokens": 1024,
"reasoning_tokens": 0,
"status": "completed",
"api_key_id": "0b9d4f6e-2a1c-4e8b-9f37-5c6d2e1a8b40"
}
],
"next_cursor": {
"cursor_ts": "2026-11-18T21:04:11.392Z",
"cursor_id": "req_3a9e1f0c7b2d4c58a6e1d9f4b0c2a817",
"cursor_after": "2026-10-20T21:04:00+00:00"
}
}https://api.experientiallabs.ai/api/v1/usage?window=30d&model=claude-opus-5.5&api_key_id=0b9d4f6e-2a1c-4e8b-9f37-5c6d2e1a8b40&status=completed&attribution_label=customer-4821&cursor_ts=2026-11-18T21%3A04%3A11.392Z&cursor_id=req_3a9e1f0c7b2d4c58a6e1d9f4b0c2a817&cursor_after=2026-10-20T21%3A04%3A00%2B00%3A00&limit=100