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

# List Models

`GET /v1/models`

List all models available to the user.

## Query parameters

- `provider` string, nullable
- `model` string, nullable

## Response `200`

Successful Response

- ModelList
  - `object` string
  - `data` union[]
    - union
      - BaseModelCard
        - `id` string, required
        - `object` string
        - `created` integer
        - `owned_by` string
        - `capabilities` ModelCapabilities, required — This is populated by Harmattan, but some fields have a name that we don't want to expose in the API.
          - `completion_chat` boolean
          - `function_calling` boolean
          - `reasoning` boolean
          - `completion_fim` boolean
          - `fine_tuning` boolean
          - `vision` boolean
          - `ocr` boolean
          - `classification` boolean
          - `moderation` boolean
          - `audio` boolean
          - `audio_transcription` boolean
          - `audio_transcription_realtime` boolean
          - `audio_speech` boolean
          - `unified_resources` boolean
        - `name` string, nullable
        - `description` string, nullable
        - `max_context_length` integer
        - `aliases` string[]
        - `deprecation` string, date-time, nullable
        - `deprecation_replacement_model` string, nullable
        - `default_model_temperature` number, nullable
        - `internal` boolean
        - `type` 'base'
      - FTModelCard — Extra fields for fine-tuned models.
        - `id` string, required
        - `object` string
        - `created` integer
        - `owned_by` string
        - `capabilities` ModelCapabilities, required — This is populated by Harmattan, but some fields have a name that we don't want to expose in the API.
          - `completion_chat` boolean
          - `function_calling` boolean
          - `reasoning` boolean
          - `completion_fim` boolean
          - `fine_tuning` boolean
          - `vision` boolean
          - `ocr` boolean
          - `classification` boolean
          - `moderation` boolean
          - `audio` boolean
          - `audio_transcription` boolean
          - `audio_transcription_realtime` boolean
          - `audio_speech` boolean
          - `unified_resources` boolean
        - `name` string, nullable
        - `description` string, nullable
        - `max_context_length` integer
        - `aliases` string[]
        - `deprecation` string, date-time, nullable
        - `deprecation_replacement_model` string, nullable
        - `default_model_temperature` number, nullable
        - `internal` boolean
        - `type` 'fine-tuned'
        - `job` string, required
        - `root` string, required
        - `archived` boolean

## Other responses

- `422` — Validation Error

---

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