GET/api/orgs/{org_id}/provider-connections/accounts/usage

List 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_idstringrequired

    Your organization id (uuid). GET /api/whoami returns it.

Query parameters

  • daysinteger

    Trailing window in days.

    Default: 30

Responses

  • 200

    Per-account usage.

    Response
    • daysintegerrequired
    • sincestringrequired
    • accountsarray<object>required
      accounts
      • providerenumrequired

        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.

        "openai""anthropic""azure_openai""openrouter""gemini""bedrock""fireworks""modal""vertex""zai""qwen""tencent""meta""cerebras""wafer""huawei""mistral""dashscope""xai""deepseek""typesafe""kenari""kiosapi""tokenharbor""groq""nvidia_nim"
      • setup_aliasstringrequired
      • credential_last4string | nullrequired
      • credential_kindenumrequired

        What the account's credential is.

        "api_key""chatgpt_plan""claude_plan"
      • planobject | nullrequired
        One of

        object

        • labelstringrequired
        • plan_typestring | nullrequired

          For example plus, pro, team, max.

        • primaryobject | nullrequired
          One of

          object

          • used_percentintegerrequired
          • reset_atstring | nullrequired
          • window_minutesinteger | nullrequired
        • secondaryobject | nullrequired
          One of

          object

          • used_percentintegerrequired
          • reset_atstring | nullrequired
          • window_minutesinteger | nullrequired
        • derivedobject | null
          One of

          object

          • five_hourobject | nullrequired
            One of

            object

            • requestsintegerrequired
            • input_tokensintegerrequired
            • cached_input_tokensintegerrequired
            • output_tokensintegerrequired
            • first_activitystring | nullrequired
            • last_activitystring | nullrequired
          • seven_dayobject | nullrequired
            One of

            object

            • requestsintegerrequired
            • input_tokensintegerrequired
            • cached_input_tokensintegerrequired
            • output_tokensintegerrequired
            • first_activitystring | nullrequired
            • last_activitystring | nullrequired
        • checked_atstring | nullrequired
        • scopeenum

          org: the shared pool; account: only API keys created by owner_user_id.

          "org""account"
          Default: "org"
        • owner_user_idstring | null
        • rotation_pausedboolean

          A paused plan never serves.

          Default: false
        • refreshes_atstring | null

          When a plan paused for a spent window refreshes.

      • statusenumrequired

        The provider-verified key state, written by the hookup check and by real traffic. provider_error means the provider was unreachable when checked, not that the key is bad.

        "unchecked""valid""invalid""rate_limited""quota_exhausted""provider_error"
      • status_checked_atstring | nullrequired
      • priorityintegerrequired
      • exhaustion_fallbackbooleanrequired
      • ratelimit_failoverbooleanrequired
      • fundingbooleanrequired

        Whether this account currently funds its provider's traffic.

      • attemptsintegerrequired
      • completedintegerrequired
      • quota_exceededintegerrequired
      • throttledintegerrequired
      • input_tokensintegerrequired
      • cached_input_tokensintegerrequired
      • output_tokensintegerrequired
      • estimated_cost_usdnumberrequired

        List-priced value of the calls this account served, in dollars (not charged).

      • last_attempt_atstring | nullrequired
  • 401

    Missing, unknown or revoked API key.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    The resource does not exist or belongs to another organization.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 422

    The body or query failed validation.

    Response
    • detailarray<object>required
      detail
      • typestring
      • locarray<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