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.

認証: AuthorizationヘッダーにBearer形式のAPIキー

パスパラメータ

  • org_idstring必須

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

クエリパラメータ

  • daysinteger

    Trailing window in days.

    デフォルト: 30

レスポンス

  • 200

    Per-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.

        "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_aliasstring必須
      • credential_last4string | null必須
      • credential_kindenum必須

        What the account's credential is.

        "api_key""chatgpt_plan""claude_plan"
      • 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必須
        • scopeenum

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

          "org""account"
          デフォルト: "org"
        • owner_user_idstring | null
        • rotation_pausedboolean

          A paused plan never serves.

          デフォルト: false
        • refreshes_atstring | null

          When a plan paused for a spent window refreshes.

      • statusenum必須

        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 | 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必須
  • 401

    Missing, unknown or revoked API key.

    レスポンス
    • errorstring必須

      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.

    レスポンス
    • errorstring必須

      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.

    レスポンス
    • detailarray<object>必須
      detail
      • typestring
      • locarray<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