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

# List Models

`GET /v1/models`

List available models from OpenAI, Anthropic, and Google.

Calls provider APIs to get live model lists, then combines into unified response.
Only returns models from providers with configured API keys.

Returns:
    ModelsResponse: Combined list of models from all providers

## Response `200`

Successful Response

- ListModelsResponse — Response for /v1/models endpoint.
  - `object` 'list' — Response object type
  - `data` Model[], required — List of available models
    - `id` string, required — Unique model identifier with provider prefix (e.g., 'openai/gpt-4')
    - `provider` 'openai' | 'anthropic' | 'google' | 'xai' | 'mistral' | 'groq', required — Provider that hosts this model
    - `created_at` string, date-time, required — When the model was released (RFC 3339)
    - `display_name` string, nullable — Human-readable model name
    - `description` string, nullable — Model description
    - `version` string, nullable — Model version identifier
    - `capabilities` ModelCapabilities — Normalized model capabilities across all providers.
      - `text` boolean, nullable — Supports text generation
      - `vision` boolean, nullable — Supports image understanding
      - `image_generation` boolean, nullable — Supports image generation
      - `audio` boolean, nullable — Supports audio processing
      - `tools` boolean, nullable — Supports function/tool calling
      - `structured_output` boolean, nullable — Supports structured JSON output
      - `streaming` boolean, nullable — Supports streaming responses
      - `thinking` boolean, nullable — Supports extended thinking/reasoning
      - `input_token_limit` integer, nullable — Maximum input tokens
      - `output_token_limit` integer, nullable — Maximum output tokens
    - `defaults` ModelDefaults — Provider-declared default parameters for model generation.
      - `temperature` number, nullable — Default temperature setting
      - `top_p` number, nullable — Default top_p setting
      - `top_k` integer, nullable — Default top_k setting
      - `max_output_tokens` integer, nullable — Default maximum output tokens
    - `provider_info` object, nullable — Raw provider-specific metadata
    - `provider_declared_generation_methods` string[], nullable — Provider-specific generation method names (None = not declared)

## Changes

- **2025-10-09** `1b31e64d16b5` — 3 warning, 12 info
  - removed the optional property `data/items/created` from the response with the `200` status
  - removed the optional property `data/items/object` from the response with the `200` status
  - removed the optional property `data/items/owned_by` from the response with the `200` status
  - the endpoint scheme security `Bearer` was added to the API
  - …11 more
- **2025-08-18** `df6bb68fd14c` — 3 warning, 4 info
  - removed the optional property `data/items/parent` from the response with the `200` status
  - removed the optional property `data/items/permission` from the response with the `200` status
  - removed the optional property `data/items/root` from the response with the `200` status
  - api tag `models` removed
  - …3 more
- **2025-08-18** `f788f74915ca` — 1 breaking, 6 info
  - response property `data/items/created` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - api tag `models` added
  - added the optional property `data/items/parent` to the response with the `200` status
  - added the optional property `data/items/permission` to the response with the `200` status
  - …3 more
- …earlier changes not shown

[Full history](https://skmtc.dev/dedalus-labs/apis/dedalus-api/changes/v1/models/get.md)

---

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