API v1Updated 2026-09-16

Model Catalog

GET /v1/models — list every visible model and its public identifier, ordered for discovery.

GET /v1/models returns the list of models you can call through the gateway. Each model's id is the <public-name> you pass in the model field of a request. The list is ordered by discovery relevance: higher-ranked models first, then alphabetically by public name.

Endpoint#

GET/v1/models

Auth: api-key

List all visible models. No request body. Returns an OpenAI-style object: "list" envelope.

Responses

200The list of visible models.

{
  "object": "list",
  "data": [
    {
      "id": "<public-name>",
      "object": "model"
    }
  ]
}

401`invalid_api_key` — missing key, wrong key, or two headers with different values.

Response shape#

The response is intentionally minimal: object is "list", and each entry in data carries an id (the <public-name> identifier) and object: "model". Pricing, supplier, and margin fields are never exposed here — for prices use the pricing page, and for your balances use your workspace.

List models

curl "https://api.zrouter.dev/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

Using a model#

Take any id from the response and pass it as model in a chat completion, response, or message request. The identifier is the same across all three protocols.