---
title: "List available models"
method: GET
path: "/v1/models"
tags: ["Models"]
---

# List available models

`GET /v1/models`

Lists available models. If provider is not specified, lists all models from all configured providers.

If a virtual key is provided, Bifrost only lists (and only queries) providers allowed by that virtual key.

## Query parameters

- `provider` 'openai' | 'azure' | 'anthropic' | 'bedrock' | 'cohere' | 'vertex' | 'vllm' | 'mistral' | 'ollama' | 'groq' | 'sgl' | 'parasail' | 'perplexity' | 'replicate' | 'cerebras' | 'deepseek' | 'gemini' | 'openrouter' | 'elevenlabs' | 'huggingface' | 'nebius' | 'xai' | 'runway' | 'fireworks' — AI model provider identifier
- `page_size` integer
- `page_token` string

## Response `200`

Successful response

- ListModelsResponse
  - `data` Model[]
    - `id` string — Model ID in provider/model format
    - `canonical_slug` string
    - `name` string
    - `normalized_name` string — Human-readable name derived from the Bifrost datasheet base model (e.g. "Claude Sonnet 4.5"). Only present when the model has a matching entry in the Bifrost pricing catalog.
    - `deployment` string
    - `created` integer
    - `context_length` integer
    - `max_input_tokens` integer
    - `max_output_tokens` integer
    - `architecture` object
      - `modality` string
      - `tokenizer` string
      - `instruct_type` string
      - `input_modalities` string[]
      - `output_modalities` string[]
    - `pricing` object
      - `prompt` string
      - `completion` string
      - `request` string
      - `image` string
      - `web_search` string
      - `internal_reasoning` string
      - `input_cache_read` string
      - `input_cache_write` string
    - `top_provider` object
      - `is_moderated` boolean
      - `context_length` integer
      - `max_completion_tokens` integer
    - `per_request_limits` object
      - `prompt_tokens` integer
      - `completion_tokens` integer
    - `supported_parameters` string[]
    - `default_parameters` object
      - `temperature` number
      - `top_p` number
      - `frequency_penalty` number
    - `hugging_face_id` string
    - `description` string
    - `owned_by` string
    - `supported_methods` string[]
  - `extra_fields` BifrostResponseExtraFields — Additional fields included in responses
    - `request_type` string — Type of request that was made
    - `provider` 'openai' | 'azure' | 'anthropic' | 'bedrock' | 'cohere' | 'vertex' | 'vllm' | 'mistral' | 'ollama' | 'groq' | 'sgl' | 'parasail' | 'perplexity' | 'replicate' | 'cerebras' | 'deepseek' | 'gemini' | 'openrouter' | 'elevenlabs' | 'huggingface' | 'nebius' | 'xai' | 'runway' | 'fireworks' — AI model provider identifier
    - `model_requested` string — The model that was requested
    - `model_deployment` string — The actual model deployment used
    - `latency` integer — Request latency in milliseconds
    - `chunk_index` integer — Index of the chunk for streaming responses
    - `raw_request` object — Raw request if enabled
    - `raw_response` object — Raw response if enabled
    - `cache_debug` BifrostCacheDebug
      - `cache_hit` boolean
      - `cache_id` string
      - `hit_type` string
      - `requested_provider` string
      - `requested_model` string
      - `provider_used` string
      - `model_used` string
      - `input_tokens` integer
      - `threshold` number
      - `similarity` number
  - `next_page_token` string

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/getbifrost/apis/bifrost-api.md) · [All operations](https://skmtc.net/getbifrost/apis/bifrost-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbifrost/bifrost-api/revisions/f8cab88f64ea/schema)