For the complete documentation index, see llms.txt. This page is also available as Markdown.

Catalog

List Catalog

get

The models this caller may use, one entry each however many providers serve it.

Prices are the caller's: an organization's override where one applies, else the deployment's row, else the models.dev default. Aliases and routing policies are not models and are not listed; see Routing. A visitor, where the catalog is public, sees the configured instances and the hosted models every organization reaches, at the deployment's rates, and nothing that belongs to a tenant.

Authorizations
Otari-KeystringRequired

Enter your API key here (sent as Otari-Key header).

Query parameters
at_contextinteger · min: 1 · nullableOptional

Compare prices for a request of this many input tokens: each model's minimum is taken from the pricing tier that request would settle at. Omitted, the base rates compare.

searchstring · max: 200 · nullableOptional

Case-insensitive text in a model's name, vendor, id, selectors, or provider instances.

workspace_idstring · uuid · nullableOptional

For a signed-in caller, list only what a request billed to this workspace may call, with its own disabled keys and model lists applied. A workspace the caller cannot see answers 404. Ignored for an API key, which already names its workspace.

skipintegerOptional

Number of matching models to skip.

Default: 0
limitinteger · min: 1 · max: 1000Optional

Maximum number of models to return.

Default: 100
providerstring[] · max: 100Optional

Match any named provider instance.

vendorstring[] · max: 100Optional

Match any vendor; an empty value names unknown vendors.

input_modalitystring[] · max: 100Optional

Require every input modality.

output_modalitystring[] · max: 100Optional

Require every output modality.

min_contextintegerOptional

Minimum context window; unknown windows do not match.

Default: 0
max_inputnumber · nullableOptional

Maximum cheapest input price per million tokens; unpriced models, and models priced in another unit, do not match.

pricingstring · enumOptionalDefault: allPossible values:
sourcestring · enumOptionalDefault: allPossible values:
zero_data_retentionbooleanOptional

Only models at least one provider declared to keep no prompt or completion data offers.

Default: false
released_within_daysinteger · max: 36500Optional

Release window ending today (UTC); zero disables it. Unknown and future releases do not match.

Default: 0
sortstring · enumOptionalDefault: namePossible values:
directionstring · enumOptionalDefault: ascPossible values:
include_facetsbooleanOptional

Include the filter choices drawn from the whole authorized catalog.

Default: false
Responses
200

Successful Response

application/json

The grouped catalog, and the facts a reader needs to interpret its prices.

countintegerRequired

Models matching all filters before paging.

default_pricingbooleanRequired

Whether an unpriced model is metered at the models.dev default.

defaults_as_ofstring · date-time · nullableRequired

When the accepted models.dev snapshot, which the defaults are billed from, was taken. Null while the bundled snapshot serves.

metadata_availablebooleanRequired

False when models.dev could not be read; descriptions are then absent.

get/api/v1/catalog/models
GET /api/v1/catalog/models HTTP/1.1
Otari-Key: YOUR_API_KEY
Accept: */*
{
  "count": 1,
  "default_pricing": true,
  "defaults_as_of": "2026-01-01T00:00:00.000Z",
  "facets": {
    "providers": [
      "text"
    ],
    "total_count": 1,
    "types": [
      "chat"
    ],
    "vendors": [
      {
        "value": "text",
        "vendor_slug": "text"
      }
    ]
  },
  "metadata_available": true,
  "models": [
    {
      "capabilities": {
        "attachment": false,
        "reasoning": false,
        "structured_output": false,
        "temperature": false,
        "tool_call": false
      },
      "context_window": 1,
      "deprecated": false,
      "description": "text",
      "discovered": true,
      "family": "text",
      "id": "text",
      "input_modalities": [
        "text"
      ],
      "knowledge_cutoff": "text",
      "max_output_tokens": 1,
      "min_input_price_per_million": 1,
      "min_output_price_per_million": 1,
      "name": "text",
      "offering_count": 1,
      "open_weights": false,
      "output_modalities": [
        "text"
      ],
      "price_sources": [
        "organization"
      ],
      "price_unit": "token",
      "provider_count": 1,
      "providers": [
        "text"
      ],
      "release_date": "text",
      "resolves_to": "text",
      "selector": "text",
      "selectors": [
        "text"
      ],
      "type": "chat",
      "unpriced_count": 1,
      "vendor": "text",
      "zero_data_retention_providers": [
        "text"
      ]
    }
  ]
}

Get Catalog Model

get

One model and every offering of it this caller may use.

The whole merged catalog is built and grouped to answer for one model. That is deliberate: the identity a model is found by is a property of the group, so narrowing the build to one model would need the grouping done first. The query count is constant; the cost is CPU per page view, growing with the size of the catalog rather than with the number of readers.

A model the caller may not see answers 404, the same as one that does not exist, so the route cannot be used to probe the catalog behind an allow-list. A signed-in caller's offerings also carry their organization's own usage of each over the last 30 days.

Authorizations
Otari-KeystringRequired

Enter your API key here (sent as Otari-Key header).

Path parameters
model_idstringRequired
Query parameters
workspace_idstring · uuid · nullableOptional

For a signed-in caller, only the offerings a request billed to this workspace may call.

Responses
200

Successful Response

application/json

One model with everything the detail page shows.

context_windowinteger · nullableOptional

The largest any offering serves.

default_pricingbooleanRequired

Whether an unpriced model is metered at the models.dev default.

deprecatedbooleanOptional

True only when every offering with metadata says so.

Default: false
descriptionstring · nullableOptional

models.dev's, from the offering that named the model.

discoveredbooleanRequired

Whether any offering was discovered from its provider.

familystring · nullableOptional
idstringRequired

The catalog id, vendor-qualified where the vendor is known: z-ai/glm-5.3, else the bare slug.

input_modalitiesstring[]Required
knowledge_cutoffstring · nullableOptional
max_output_tokensinteger · nullableOptional

The largest any offering serves.

min_input_price_per_millionnumber · nullableOptional

The cheapest offering's, per million of price_unit, at the comparison context where one was asked for.

min_output_price_per_millionnumber · nullableOptional
namestringRequired
offering_countintegerRequired
open_weightsbooleanOptionalDefault: false
output_modalitiesstring[]Required
price_unitstring · enum · nullableOptional

What the cheapest prices are per: the unit every priced offering is priced in. Null where no offering is priced, or where offerings are priced in different units, which leaves both null.

Possible values:
provider_countintegerRequired
providersstring[]Required

The provider instances offering it, sorted.

release_datestring · nullableOptional
resolves_tostring · nullableOptional

The offering selector resolves to.

selectorstring · nullableOptional

The id as a selector: send it as model and the best offering the caller can reach answers. Priced offerings come first, and among them the organization's own key, then the vendor's own provider, then the cheapest. Null until the gateway has indexed the catalog.

selectorsstring[]Required

Every offering's selector, so the list can be searched by one.

typestring · enum · nullableOptional

What kind of model it is: the kind most of its offerings give, from the provider's listing or models.dev. A tie goes to the vendor's own provider. Null where no offering gives one.

Possible values:
unpriced_countintegerRequired

How many offerings carry no price for this caller.

vendorstring · nullableRequired
zero_data_retention_providersstring[]Optional

The provider instances offering it that are declared to keep no prompt or completion data, sorted.

get/api/v1/catalog/models/{model_id}
GET /api/v1/catalog/models/{model_id} HTTP/1.1
Otari-Key: YOUR_API_KEY
Accept: */*
{
  "also_available_from": [
    {
      "name": "text",
      "provider_type": "text"
    }
  ],
  "capabilities": {
    "attachment": false,
    "reasoning": false,
    "structured_output": false,
    "temperature": false,
    "tool_call": false
  },
  "context_window": 1,
  "default_pricing": true,
  "deprecated": false,
  "description": "text",
  "discovered": true,
  "family": "text",
  "id": "text",
  "input_modalities": [
    "text"
  ],
  "knowledge_cutoff": "text",
  "max_output_tokens": 1,
  "min_input_price_per_million": 1,
  "min_output_price_per_million": 1,
  "name": "text",
  "offering_count": 1,
  "offerings": [
    {
      "context_window": 1,
      "credential": "deployment",
      "discovered": true,
      "endpoints": [
        "/chat/completions"
      ],
      "max_output_tokens": 1,
      "metadata_input_price_per_million": 1,
      "metadata_output_price_per_million": 1,
      "price_reference": "text",
      "price_source": "organization",
      "pricing": {
        "cache_read_price_per_million": 1,
        "cache_write_price_per_million": 1,
        "input_price_per_million": 1,
        "output_price_per_million": 1,
        "pricing_tiers": [
          {
            "cache_read_price_per_million": 1,
            "cache_write_price_per_million": 1,
            "input_price_per_million": 1,
            "min_input_tokens": 1,
            "output_price_per_million": 1
          }
        ],
        "rates": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "unit": "token"
      },
      "provider": "text",
      "provider_type": "text",
      "quantization": "text",
      "selector": "text",
      "short_selector": "text",
      "usage_30d": {
        "cache_hit_rate": 1,
        "cache_read_tokens": 1,
        "effective_price_per_million": 1,
        "requests": 1,
        "spend_usd": 1,
        "total_tokens": 1
      },
      "zero_data_retention": false
    }
  ],
  "open_weights": false,
  "output_modalities": [
    "text"
  ],
  "price_sources": [
    "organization"
  ],
  "price_unit": "token",
  "provider_count": 1,
  "providers": [
    "text"
  ],
  "release_date": "text",
  "resolves_to": "text",
  "selector": "text",
  "selectors": [
    "text"
  ],
  "type": "chat",
  "unpriced_count": 1,
  "vendor": "text",
  "zero_data_retention_providers": [
    "text"
  ]
}

Refresh Selector Index

post

Re-index the short spellings now, rather than on the refresher's next tick.

Authorizations
Otari-KeystringRequired

Enter your API key here (sent as Otari-Key header).

Responses
200

Successful Response

application/json

What the rebuilt index knows.

modelsintegerRequired

Slugs that resolve to an offering.

offeringsintegerRequired

Selectors the deployment serves.

pinned_selectorsintegerRequired

Pinned spellings, one per instance a model is offered on.

post/api/v1/catalog/selectors/refresh
POST /api/v1/catalog/selectors/refresh HTTP/1.1
Otari-Key: YOUR_API_KEY
Accept: */*
200

Successful Response

{
  "models": 1,
  "offerings": 1,
  "pinned_selectors": 1
}

Last updated

Was this helpful?