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.

Authentication: Bearer API key in the Authorization header

Path parameters

  • org_idstringrequired

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

Responses

  • 200

    The provider home.

    Response
    • providerobjectrequired

      Your provider registry row.

      provider
      • slugstringrequired
      • display_namestringrequired
      • familyenumrequired
        "native""openai_compatible"
      • base_urlstring | nullrequired

        The OpenAI-compatible base URL the gateway calls.

      • auth_modeenumrequired

        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"
      • statusenumrequired

        Provider lifecycle.

        "onboarding""canary""live""offboarded"
      • max_concurrencyinteger | nullrequired
      • advertised_tpsnumber | nullrequired
      • data_policyobjectrequired

        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_promptsbooleanrequired
        • retention_daysinteger | null

          Days prompts are kept.

        • trains_on_databooleanrequired
        • zero_data_retentionbooleanrequired
        • policy_urlstring | null

          Public https URL of the policy.

      • contactobjectrequired
        contact
        • emailstringrequired

          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 | nullrequired
      • credential_last4string | nullrequired

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

      • has_credentialbooleanrequired
      • stripe_account_idstring | nullrequired

        Linked Stripe Connect account.

      • payouts_enabledbooleanrequired

        Whether Stripe reports the linked account payout-ready.

    • lanesarray<object>required
      lanes
      • lane_idstringrequired
      • model_slugstringrequired
      • model_display_namestringrequired
      • wire_idstringrequired
      • pricesobjectrequired

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

        prices
        • input_nano_usd_per_millioninteger | nullrequired
        • cached_input_nano_usd_per_millioninteger | nullrequired
        • output_nano_usd_per_millioninteger | nullrequired
        • reasoning_nano_usd_per_millioninteger | nullrequired
      • data_policyobject | nullrequired
        One of

        object

        • retains_promptsbooleanrequired
        • retention_daysinteger | null

          Days prompts are kept.

        • trains_on_databooleanrequired
        • zero_data_retentionbooleanrequired
        • policy_urlstring | null

          Public https URL of the policy.

      • dispatchobject | nullrequired
        One of

        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 | nullrequired

        Observed output tokens per second from real traffic.

      • stats_sourcestring | nullrequired
      • rate_limitsobject | nullrequired

        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 | nullrequired

        Rollout stage, for example canary (limited rollout).

      • statusstringrequired

        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_requestsintegerrequired
        • min_reliability_pctnumberrequired
        • observed_requestsintegerrequired

          Successful requests in the observed window.

        • reliability_pctnumber | nullrequired
        • promote_eligiblebooleanrequired

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

    • pending_requestsarray<object>required
      pending_requests
      • idstringrequired
      • kindenumrequired
        "add_models""update_prices""update_limits""update_model"
      • statusenumrequired
        "pending""approved""rejected""applied""failed"
      • payloadobjectrequired

        The validated payload as stored.

      • effective_atstring | nullrequired
      • review_notestring | nullrequired

        The reviewer's note on a reviewed request.

      • errorstring | nullrequired

        Why an approved request failed to apply.

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

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

Request

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

Response

{
  "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