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

# Get Models

`GET /v1/models`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

Lists the currently available models and provides basic information.

## Response `200`

Successful Response

- ModelsResponse
  - `object` 'list': Type of the object.
  - `data` Model[], required: List of models.
    - `object` 'model': Type of the object.
    - `id` string, required: The model identifier, which can be referenced in the API endpoints.
    - `type` 'automatic-speech-recognition' | 'image-to-text' | 'text-classification' | 'text-embeddings-inference' | 'text-generation', required
    - `aliases` string[]: Aliases of the model. It will be used to identify the model by users.
    - `created` integer, required: Time of creation, as Unix timestamp.
    - `owned_by` string, required: The organization that owns the model.
    - `max_context_length` integer, nullable: Maximum amount of tokens a context could contains. Makes sure it is the same for all models.
    - `costs` ModelCosts
      - `prompt_tokens` number: Cost of a million prompt tokens (decrease user budget)
      - `completion_tokens` number: Cost of a million completion tokens (decrease user budget)

## Other responses

- `401`: Invalid authentication scheme.<br>Invalid API key.
- `403`: Your account has expired. Please contact support to renew your account.

## Changes

- **2026-09-29** `2f7a4a0aac8f`: 1 info
  - endpoint added
- **2026-09-29** `da70d9cd1957`: 1 breaking
  - api path removed without deprecation
- **2026-09-21** `5fdbd3614b8c`: 1 breaking, 5 warning, 2 info
  - the `data/items/type` response's property type changed from no type to `string` for status `200`
  - added the new `automatic-speech-recognition` enum value to the `data/items/type` response property for the response status `200`
  - added the new `image-to-text` enum value to the `data/items/type` response property for the response status `200`
  - added the new `text-classification` enum value to the `data/items/type` response property for the response status `200`
  - …4 more
- **2026-05-23** `d3e7e6dcdd41`: 2 info
  - added the non-success response with the status `403`
  - removed the non-success response with the status `404`
- **2026-04-30** `d5f1d3d5614e`: 2 info
  - added `#/components/schemas/api__domain__model__entities__ModelType` to the `data/items/type` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/ModelType` from the `data/items/type` response property `anyOf` list for the response status `200`

[Operation history](https://skmtc.dev/betagouv/apis/opengatellm/changes/v1/models/get.md)

---

[API](https://skmtc.dev/betagouv/apis/opengatellm.md) - [All operations](https://skmtc.dev/betagouv/apis/opengatellm/llms.txt) - [OpenAPI document](https://skmtc.dev/betagouv/apis/opengatellm/revisions/2f7a4a0aac8f?raw)