GET
https://your-instance.com/v1/modelsReturns 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
GET
https://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
GET
https://your-instance.com/v1beta/modelsThe same catalogue in Gemini's own listing shape, for clients built against that SDK.
