GET/api/orgs/{org_id}/provider

Get the provider home

Your provider registry row, every public model lane you serve, and up to 100 open change requests. Any org member or the org's own key may read it. An org that operates no provider answers 404, the same as an unknown org.

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

パスパラメータ

  • org_idstring必須

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

レスポンス

  • 200

    The provider home.

    レスポンス
    • providerobject必須

      Your provider registry row.

      provider
      • slugstring必須
      • display_namestring必須
      • familyenum必須
        "native""openai_compatible"
      • base_urlstring | null必須

        The OpenAI-compatible base URL the gateway calls.

      • auth_modeenum必須

        house_key: the platform holds your key. none: no stored key. native: a built-in integration whose credential the platform manages.

        "house_key""none""native"
      • statusenum必須

        Provider lifecycle.

        "onboarding""canary""live""offboarded"
      • max_concurrencyinteger | null必須
      • advertised_tpsnumber | null必須
      • data_policyobject必須

        Self-declared prompt-data handling. retention_days is required when retains_prompts is true and must be omitted otherwise; zero_data_retention requires retains_prompts and trains_on_data both false.

        data_policy
        • retains_promptsboolean必須
        • retention_daysinteger | null

          Days prompts are kept.

        • trains_on_databoolean必須
        • zero_data_retentionboolean必須
        • policy_urlstring | null

          Public https URL of the policy.

      • contactobject必須
        contact
        • emailstring必須

          Where the platform reaches you when a lane misbehaves.

        • escalationstring | null

          Free-form escalation instructions (pager, shared channel, phone).

        • status_pagestring | null

          Public https status page.

      • logo_urlstring | null必須
      • credential_last4string | null必須

        Last four characters of the stored house key. The key itself is never returned.

      • has_credentialboolean必須
      • stripe_account_idstring | null必須

        Linked Stripe Connect account.

      • payouts_enabledboolean必須

        Whether Stripe reports the linked account payout-ready.

    • lanesarray<object>必須
      lanes
      • lane_idstring必須
      • model_slugstring必須
      • model_display_namestring必須
      • wire_idstring必須
      • pricesobject必須

        Lane rates in integer nano-USD per million tokens; null means unknown, never zero.

        prices
        • input_nano_usd_per_millioninteger | null必須
        • cached_input_nano_usd_per_millioninteger | null必須
        • output_nano_usd_per_millioninteger | null必須
        • reasoning_nano_usd_per_millioninteger | null必須
      • data_policyobject | null必須
        いずれか

        object

        • retains_promptsboolean必須
        • retention_daysinteger | null

          Days prompts are kept.

        • trains_on_databoolean必須
        • zero_data_retentionboolean必須
        • policy_urlstring | null

          Public https URL of the policy.

      • dispatchobject | null必須
        いずれか

        object

        • scale_up_secondsinteger | null

          Warm-up time before saturation counts against the lane.

        • overflow_policyenum

          What happens once saturated.

          "reject""throttle"null
        • max_concurrencyinteger | null

          Declared cap on in-flight requests for this model.

      • throughput_tpsnumber | null必須

        Observed output tokens per second from real traffic.

      • stats_sourcestring | null必須
      • rate_limitsobject | null必須

        Declared and observed per-account rate limits for this wire id (observed, not enforced).

        rate_limits
        • requests_per_minuteinteger | null
        • tokens_per_minuteinteger | null
        • observed_requests_per_minuteinteger | null
        • observed_tokens_per_minuteinteger | null
      • ramp_statestring | null必須

        Rollout stage, for example canary (limited rollout).

      • statusstring必須

        Lane serving status: active is listed and callable, disabled is unlisted.

      • ladder_rankinteger | null

        Position among this model's public lanes (display only, never a routing input).

      • ladder_lane_countinteger | null
      • ladder_scorenumber | null
      • ladder_factorsobject | null

        Score breakdown keyed by factor: reliability, ttft, decode, input_cost, output_cost.

      • rollout_progressobject | null

        For a canary lane, progress toward automatic promotion to full rollout.

        rollout_progress
        • min_requestsinteger必須
        • min_reliability_pctnumber必須
        • observed_requestsinteger必須

          Successful requests in the observed window.

        • reliability_pctnumber | null必須
        • promote_eligibleboolean必須

          True when the lane clears the bar; the next scheduled run promotes it.

    • pending_requestsarray<object>必須
      pending_requests
      • idstring必須
      • kindenum必須
        "add_models""update_prices""update_limits""update_model"
      • statusenum必須
        "pending""approved""rejected""applied""failed"
      • payloadobject必須

        The validated payload as stored.

      • effective_atstring | null必須
      • review_notestring | null必須

        The reviewer's note on a reviewed request.

      • errorstring | null必須

        Why an approved request failed to apply.

      • created_atstring必須
      • applied_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 org is not yours, or it operates no provider.

    レスポンス
    • 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).

リクエスト

curl https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンス

{
  "provider": {
    "slug": "acme-inference",
    "display_name": "Acme Inference",
    "family": "openai_compatible",
    "base_url": "https://api.acme-inference.example/v1",
    "auth_mode": "house_key",
    "status": "canary",
    "max_concurrency": 256,
    "advertised_tps": 80,
    "data_policy": {
      "retains_prompts": false,
      "retention_days": null,
      "trains_on_data": false,
      "zero_data_retention": true,
      "policy_url": "https://acme-inference.example/privacy"
    },
    "contact": {
      "email": "oncall@acme-inference.example",
      "escalation": "PagerDuty: acme-llm",
      "status_page": "https://status.acme-inference.example"
    },
    "logo_url": null,
    "credential_last4": "9f3a",
    "has_credential": true,
    "stripe_account_id": "acct_1Q2w3E4r5T6y7U8i",
    "payouts_enabled": true
  },
  "lanes": [
    {
      "lane_id": "7c1e9a52-4b3d-4f0e-a8c6-2d5b9e1f0a37",
      "model_slug": "llama-4.1-70b-instruct",
      "model_display_name": "Llama 4.1 70B Instruct",
      "wire_id": "meta-llama/llama-4.1-70b-instruct",
      "prices": {
        "input_nano_usd_per_million": 350000000,
        "cached_input_nano_usd_per_million": 35000000,
        "output_nano_usd_per_million": 900000000,
        "reasoning_nano_usd_per_million": null
      },
      "data_policy": {
        "retains_prompts": false,
        "retention_days": null,
        "trains_on_data": false,
        "zero_data_retention": true,
        "policy_url": null
      },
      "dispatch": {
        "scale_up_seconds": 30,
        "overflow_policy": "reject",
        "max_concurrency": 128
      },
      "throughput_tps": 74.2,
      "stats_source": "observed",
      "rate_limits": {
        "requests_per_minute": 600,
        "tokens_per_minute": 2000000,
        "observed_requests_per_minute": 412,
        "observed_tokens_per_minute": null
      },
      "ramp_state": "canary",
      "status": "active",
      "ladder_rank": 2,
      "ladder_lane_count": 4,
      "ladder_score": 0.71,
      "ladder_factors": {
        "reliability": {
          "value": 99.6,
          "normalized": 0.95,
          "weight": 0.35
        },
        "ttft": {
          "value": 410,
          "normalized": 0.62,
          "weight": 0.2
        },
        "decode": {
          "value": 74.2,
          "normalized": 0.58,
          "weight": 0.15
        },
        "input_cost": {
          "value": 350000000,
          "normalized": 0.8,
          "weight": 0.15
        },
        "output_cost": {
          "value": 900000000,
          "normalized": 0.66,
          "weight": 0.15
        }
      },
      "rollout_progress": {
        "min_requests": 500,
        "min_reliability_pct": 98,
        "observed_requests": 312,
        "reliability_pct": 99.6,
        "promote_eligible": false
      }
    }
  ],
  "pending_requests": [
    {
      "id": "2b8f6d41-9c0e-4a7b-b3d5-6e1f2a9c8d04",
      "kind": "update_limits",
      "status": "pending",
      "payload": {
        "max_concurrency": 512,
        "advertised_tps": 95
      },
      "effective_at": null,
      "review_note": null,
      "error": null,
      "created_at": "2026-11-18T14:02:11.402Z",
      "applied_at": null
    }
  ]
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider