List the provider endpoints that can serve a model

Every Inference Provider endpoint that can serve the model for this key, in the order Stav tries them, each with its own context window, max output tokens and quantization. Same shape and field names as OpenRouter's /api/v1/models/{author}/{slug}/endpoints.

Only endpoints a request could actually reach are listed: your workspace's policy (sovereignty floor, compute region, ZDR, blocked providers) applies. Send an entry's id as model to pin that endpoint.

For a Router (or auto, your workspace's default Router), the list is every endpoint of every model the Router can pick, under the Router's own rules as well, best model first. Each entry's model_id names its model, and data.stav_router is true. The models are paged with page and page_size (at most 100); data.stav_total_models is the whole pool.

Path parameters

• model_idstringrequired

  Anything you can send as model: a catalogue slug (openai/gpt-oss-120b), a bare name with one match, a Router (@your-workspace/router) or auto.

Query parameters

• pageinteger

  Router or auto only. The page of the Router's models.

  Default: 1
• page_sizeinteger

  Router or auto only. Models per page.

  Default: 100

Header parameters

• X-Stav-Runs-Instring

  Where this request may run, as a header: eu, eea, one ISO 3166 alpha-2 country code, or a comma-separated list of codes (NO, SE). The same values and the same meaning as the provider.runs_in body field, for clients that can set fixed headers but not body fields (an SDK's default_headers). It filters the Provider Endpoints that may serve and every failover; when none passes, the request is refused (403 endpoint_not_admissible) and nothing is sent.

  It only ever narrows. Sent together with provider.runs_in, both must hold: X-Stav-Runs-In: eea with "runs_in": "NO" runs in Norway; X-Stav-Runs-In: eu with "runs_in": "NO" or "US" has no country in common and is 400 invalid_value. It never widens your workspace policy. A value Stav cannot read, an empty one, or two header lines with different values is 400 invalid_value with param X-Stav-Runs-In; the same value sent twice counts once. The request log shows the region with its source.

  GET /v1/models lists only models with an endpoint inside it, and a Router or auto only when at least one of its candidates has one (without a key, auto is not listed under the header); GET /v1/models/{model_id}/endpoints lists only those endpoints. /v1/messages/count_tokens reads it too: when the provider's own counter is outside it, the count is a local estimate and the prompt is never sent. The response header X-Stav-Token-Count says exact or estimate. Reading or cancelling a stored response (GET /v1/responses/{id}, /input_items, /cancel) held by an endpoint outside it is refused with 403 endpoint_not_admissible; DELETE is not refused, so data held outside the region can always be erased.

Errors

Every error code, what it means and what to do: Errors.