/api/orgs/{org_id}/provider-connections/accounts/usageList provider account usage
Every account of the org in pool order with its verdict, pool controls, whether it funds its provider's traffic right now, and gateway usage over a trailing window (exactly the calls its credential served). estimated_cost_usd is the list-priced value in dollars; BYOK traffic is never charged against your credits. Any member may read.
Authentication: Bearer API key in the Authorization header
Path parameters
org_idstringrequiredYour organization id (uuid).
GET /api/whoamireturns it.
Query parameters
daysintegerTrailing window in days.
Responses
200Per-account usage.
Response
daysintegerrequiredsincestringrequiredaccountsarray<object>requiredaccounts
providerenumrequiredA provider an organization can connect its own key for. kenari, kiosapi, tokenharbor, groq and nvidia_nim are free-tier providers open to every plan.
setup_aliasstringrequiredcredential_last4string | nullrequiredcredential_kindenumrequiredWhat the account's credential is.
planobject | nullrequiredOne of
object
labelstringrequiredplan_typestring | nullrequiredFor example plus, pro, team, max.
primaryobject | nullrequiredOne of
object
used_percentintegerrequiredreset_atstring | nullrequiredwindow_minutesinteger | nullrequired
secondaryobject | nullrequiredOne of
object
used_percentintegerrequiredreset_atstring | nullrequiredwindow_minutesinteger | nullrequired
derivedobject | nullOne of
object
five_hourobject | nullrequiredOne of
object
requestsintegerrequiredinput_tokensintegerrequiredcached_input_tokensintegerrequiredoutput_tokensintegerrequiredfirst_activitystring | nullrequiredlast_activitystring | nullrequired
seven_dayobject | nullrequiredOne of
object
requestsintegerrequiredinput_tokensintegerrequiredcached_input_tokensintegerrequiredoutput_tokensintegerrequiredfirst_activitystring | nullrequiredlast_activitystring | nullrequired
checked_atstring | nullrequiredscopeenumorg: the shared pool;account: only API keys created byowner_user_id.owner_user_idstring | nullrotation_pausedbooleanA paused plan never serves.
refreshes_atstring | nullWhen a plan paused for a spent window refreshes.
statusenumrequiredThe provider-verified key state, written by the hookup check and by real traffic.
provider_errormeans the provider was unreachable when checked, not that the key is bad.status_checked_atstring | nullrequiredpriorityintegerrequiredexhaustion_fallbackbooleanrequiredratelimit_failoverbooleanrequiredfundingbooleanrequiredWhether this account currently funds its provider's traffic.
attemptsintegerrequiredcompletedintegerrequiredquota_exceededintegerrequiredthrottledintegerrequiredinput_tokensintegerrequiredcached_input_tokensintegerrequiredoutput_tokensintegerrequiredestimated_cost_usdnumberrequiredList-priced value of the calls this account served, in dollars (not charged).
last_attempt_atstring | nullrequired
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).
422The body or query failed validation.
Response
detailarray<object>requireddetail
typestringlocarray<string | integer>msgstring
Request
curl https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections/accounts/usage?days=7 \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"days": 7,
"since": "2026-11-12T14:15:00.000000+00:00",
"accounts": [
{
"provider": "openai",
"setup_alias": "openai-main",
"credential_last4": "x9Qa",
"credential_kind": "api_key",
"plan": null,
"status": "valid",
"status_checked_at": "2026-11-19T14:02:11.482Z",
"priority": 0,
"exhaustion_fallback": true,
"ratelimit_failover": true,
"funding": true,
"attempts": 4210,
"completed": 4188,
"quota_exceeded": 0,
"throttled": 17,
"input_tokens": 38102455,
"cached_input_tokens": 21044310,
"output_tokens": 2210877,
"estimated_cost_usd": 61.37,
"last_attempt_at": "2026-11-19T14:14:52.004Z"
}
]
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections/accounts/usage?days=7