/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.
認証: AuthorizationヘッダーにBearer形式のAPIキー
パスパラメータ
org_idstring必須Your organization id (uuid).
GET /api/whoamireturns it.
クエリパラメータ
daysintegerTrailing window in days.
レスポンス
200Per-account usage.
レスポンス
daysinteger必須sincestring必須accountsarray<object>必須accounts
providerenum必須A 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_aliasstring必須credential_last4string | null必須credential_kindenum必須What the account's credential is.
planobject | null必須いずれか
object
labelstring必須plan_typestring | null必須For example plus, pro, team, max.
primaryobject | null必須いずれか
object
used_percentinteger必須reset_atstring | null必須window_minutesinteger | null必須
secondaryobject | null必須いずれか
object
used_percentinteger必須reset_atstring | null必須window_minutesinteger | null必須
derivedobject | nullいずれか
object
five_hourobject | null必須いずれか
object
requestsinteger必須input_tokensinteger必須cached_input_tokensinteger必須output_tokensinteger必須first_activitystring | null必須last_activitystring | null必須
seven_dayobject | null必須いずれか
object
requestsinteger必須input_tokensinteger必須cached_input_tokensinteger必須output_tokensinteger必須first_activitystring | null必須last_activitystring | null必須
checked_atstring | null必須scopeenumorg: 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.
statusenum必須The 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 | null必須priorityinteger必須exhaustion_fallbackboolean必須ratelimit_failoverboolean必須fundingboolean必須Whether this account currently funds its provider's traffic.
attemptsinteger必須completedinteger必須quota_exceededinteger必須throttledinteger必須input_tokensinteger必須cached_input_tokensinteger必須output_tokensinteger必須estimated_cost_usdnumber必須List-priced value of the calls this account served, in dollars (not charged).
last_attempt_atstring | null必須
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).
404The resource does not exist or belongs to another 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).
422The body or query failed validation.
レスポンス
detailarray<object>必須detail
typestringlocarray<string | integer>msgstring
リクエスト
curl https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections/accounts/usage?days=7 \
-H "Authorization: Bearer YOUR_API_KEY"レスポンス
{
"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