CloseRouter
Documentation

Catalog API

List models, filter results, and inspect prices and supported parameters.

List models

curl
export CLOSEROUTER_API_KEY="closerouter_your_key"

curl https://api.closerouter.dev/v1/models \
  -H "Authorization: Bearer $CLOSEROUTER_API_KEY"

Filter the catalog

curl
curl https://api.closerouter.dev/v1/model-authors \
  -H "Authorization: Bearer $CLOSEROUTER_API_KEY"

curl "https://api.closerouter.dev/v1/models?model_authors=anthropic,openai&limit=50&offset=0" \
  -H "Authorization: Bearer $CLOSEROUTER_API_KEY"

Filters and pagination

ParameterRule
model_authorsComma-separated developer slugs, combined with OR. Unknown slug: 400 invalid_model_author.
input_modalities, output_modalitiesComma-separated input/output modalities. Combined with the developer filter using AND.
limit1–1000. Omit it for a flat unpaginated list.
offsetNon-negative offset. Paginated responses include total_count and links.next.

Reading the response

Illustrative fragment. Pricing units are usd_per_million_tokens, usd_per_image or usd_per_second; use the current catalog values.

JSON
{
  "data": [
    {
      "id": "openai/example-model",
      "architecture": {
        "input_modalities": [
          "text"
        ],
        "output_modalities": [
          "text"
        ]
      },
      "endpoints": [
        {
          "type": "chat",
          "supports_streaming": true
        },
        {
          "type": "responses",
          "supports_streaming": true
        }
      ]
    }
  ]
}

Capabilities and access

GET /models/{developer}/{model}/endpoints describes streaming and supported parameters. Check the selected provider’s capabilities. A restricted key sees only allowed models, including in /models/count and /model-authors.

Related methods