List models

Ask the API what it currently serves instead of hard-coding a list.

GEThttps://your-instance.com/v1/models

Returns every model your key is allowed to call. The catalogue changes as providers ship and retire models, so fetch this rather than shipping a static list that will quietly go stale.

curl https://your-instance.com/v1/models \
  -H "Authorization: Bearer $CLAWROUTER_API_KEY"
200 OK
{
  "object": "list",
  "data": [
    { "id": "claude-sonnet-5", "object": "model", "owned_by": "anthropic" },
    { "id": "gpt-5.2", "object": "model", "owned_by": "openai" }
  ]
}

One model

GEThttps://your-instance.com/v1/models/{model}

Returns the same record for a single model. A 404 here means this instance does not serve that name, which is the quickest way to check a model string before you depend on it.

Gemini format

GEThttps://your-instance.com/v1beta/models

The same catalogue in Gemini's own listing shape, for clients built against that SDK.