---
title: "List Models by Provider"
method: GET
path: "/models/provider/{provider_name}"
tags: ["Models"]
---

# List Models by Provider

`GET /models/provider/{provider_name}`

Get all models from a specific provider, including pricing information.

## Path parameters

- `provider_name` string, required

## Query parameters

- `skip` integer — Number of records to skip
- `limit` integer — Maximum number of records to return

## Headers

- `authorization` string, nullable
- `x_session_token` string, nullable

## Response `200`

Successful Response

- ModelsListResponse — Response schema for listing models.
  - `models` ModelRead[], required — List of available models
    - `name` string, required — Name of the model
    - `provider` string, required — Provider of the model (e.g., openai, anthropic)
    - `model_type` string, required — Type of model: 'llm', 'embedding', or 'image'
    - `context_limit` integer, required — Maximum context window size in tokens
    - `max_output_tokens` integer, nullable — Maximum number of output tokens
    - `supports_tools` boolean, nullable — Whether the model supports tool/function calling
    - `supports_vision` boolean, nullable — Whether the model accepts image input
    - `supports_audio_input` boolean, nullable — Whether the model accepts audio input
    - `supports_video_input` boolean, nullable — Whether the model accepts video input
    - `supports_image_output` boolean, nullable — Whether the model can generate images
    - `supports_audio_output` boolean, nullable — Whether the model can generate audio/speech
    - `supports_video_output` boolean, nullable — Whether the model can generate video
    - `supports_thinking` boolean, nullable — Whether the model is marked as reasoning/thinking capable
    - `thinking_controls` ThinkingControlsRead
      - `supported` boolean, required — Whether the model exposes configurable thinking controls
      - `allowed_fields` string[] — Public thinking fields accepted by this model
      - `defaults_only` boolean, required — Whether the model supports reasoning defaults only, without tunable controls
    - `supports_json_output` boolean, nullable — Whether the catalog marks this model as supporting JSON object / structured text responses (null if unknown)
    - `api_mode` string, nullable — API mode/routing hint (e.g., chat_completions, responses, completions)
    - `embedding_dimensions` integer, nullable — Embedding dimensions (for embedding models)
    - `input_cost_per_1m_tokens` number, nullable — Text input cost per 1M tokens (USD)
    - `cached_input_cost_per_1m_tokens` number, nullable — Cached text input cost per 1M tokens (USD)
    - `cache_write_input_cost_per_1m_tokens` number, nullable — Cache-write text input cost per 1M tokens (USD)
    - `image_input_cost_per_1m_tokens` number, nullable — Image input cost per 1M tokens (USD)
    - `output_cost_per_1m_tokens` number, nullable — Text output cost per 1M tokens (USD)
    - `image_output_cost_per_1m_tokens` number, nullable — Image output cost per 1M tokens (USD)
    - `cost_per_image` number, nullable — Flat cost per generated image (USD), for dall-e style models
    - `tier_change_token_threshold` integer, nullable — Token threshold after which tier-2 pricing applies
    - `input_cost_per_1m_tokens_tier2` number, nullable — Tier-2 input cost per 1 million tokens
    - `cached_input_cost_per_1m_tokens_tier2` number, nullable — Tier-2 cached input cost per 1 million tokens
    - `cache_write_input_cost_per_1m_tokens_tier2` number, nullable — Tier-2 cache-write input cost per 1 million tokens
    - `output_cost_per_1m_tokens_tier2` number, nullable — Tier-2 output cost per 1 million tokens
    - `last_updated` string, date-time, nullable — Last time the model was updated
  - `total` integer, required — Total number of models

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/backboard/apis/backboard-api.md) · [All operations](https://skmtc.dev/backboard/apis/backboard-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/backboard/backboard-api/revisions/e732d11ca11a/schema)