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

# List models.

`GET /v1/models`

List models. Returns OpenAI, Anthropic, or Google response format based on SDK detection headers.

## Query parameters

- `before_id` string, nullable — Return models before this model ID (Anthropic SDK format only).
- `after_id` string, nullable — Return models after this model ID (Anthropic SDK format only).
- `limit` integer, nullable — Maximum number of models to return (Anthropic SDK format only).

## Headers

- `anthropic-version` string, nullable
- `x-goog-api-key` string, nullable
- `x-goog-user-project` string, nullable
- `x-goog-api-client` string, nullable

## Response `200`

Returns OpenAI format by default. Send `anthropic-version` header for Anthropic format, or any Google SDK header (`x-goog-api-key`, `x-goog-user-project`, `x-goog-api-client`) for Google format.

- union
  - OpenAIListModelsResponse — Response containing a list of OpenAI model objects.
    - `object` 'list'
    - `data` OpenAIModel[], required — List of OpenAI model objects.
      - `id` string, required
      - `object` 'model'
      - `created` integer, required
      - `owned_by` string, required
      - `custom_metadata` object, nullable
  - AnthropicListModelsResponse — Response containing a list of Anthropic model objects.
    - `data` AnthropicModelInfo[], required — List of Anthropic model objects.
      - `id` string, required — Unique model identifier.
      - `type` 'model' — Object type, always 'model'.
      - `display_name` string, required — A human-readable name for the model.
      - `created_at` string, required — RFC 3339 datetime string representing when the model was released.
      - `max_input_tokens` integer, nullable — Maximum input context window size in tokens.
      - `max_tokens` integer, nullable — Maximum value for the max_tokens parameter when using this model.
    - `has_more` boolean — Whether there are more results in the requested page direction.
    - `first_id` string, nullable — First ID in the data list, usable as before_id for the previous page.
    - `last_id` string, nullable — Last ID in the data list, usable as after_id for the next page.
  - GoogleListModelsResponse — Response containing a list of Google model objects.
    - `models` GoogleModelInfo[], required — List of Google model objects.
      - `name` string, required — Model resource name, e.g. 'models/gemini-pro'.
      - `display_name` string, required — A human-readable name for the model.
      - `description` string — A description of the model.

## Other responses

- `400` — The request was invalid or malformed
- `429` — The client has sent too many requests in a given amount of time
- `500` — The server encountered an unexpected error
- `default` — An error occurred

---

[API](https://skmtc.net/ogx-ai/apis/ogx-specification-stable-experimental-apis.md) · [All operations](https://skmtc.net/ogx-ai/apis/ogx-specification-stable-experimental-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ogx-ai/ogx-specification-stable-experimental-apis/versions/f3f783962256/schema)