API Reference
Catalog
Reading the model catalog: models, their offerings, regions and prices, publishers and providers.
The catalog endpoints read the model catalog that routers and model groups name their models from. They need the models:read scope and have no writes. A model's offerings list each provider and variant that serves it, with the regions, wire ids and prices of each, which are the values a static router's routing.variant and routing.region take. See Model Catalog and Regions & Variants.
Endpoints
| Method | Path | Description | Scope |
|---|---|---|---|
| GET | /v1/catalog/models | List models by slug. Filter with publisher, provider and region. Paginated. | models:read |
| GET | /v1/catalog/models/{publisher}/{model} | Get one model with its limits, capabilities, modalities and offerings. | models:read |
| GET | /v1/catalog/publishers | List publishers, such as anthropic. | models:read |
| GET | /v1/catalog/providers | List providers, such as bedrock. | models:read |
The model path takes the slug's two parts as separate segments, so anthropic/claude-sonnet-4.5 is read at /v1/catalog/models/anthropic/claude-sonnet-4.5. Prices are US dollars per million tokens.
Errors
| Code | Status | Meaning |
|---|---|---|
invalid_query | 400 | A filter has an unknown value, or the query has an unknown parameter. |
invalid_path | 400 | A path segment is invalid. |
model_not_found | 404 | No catalog model has that publisher and name. |