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

# List Models

`GET /v1/models`

List available models.

The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.

## Query parameters

- `before_id` string — ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `after_id` string — ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `limit` integer — Number of items to return per page. Defaults to `20`. Ranges from `1` to `1000`.

## Headers

- `anthropic-version` string — The version of the Claude API you want to use. Read more about versioning and our version history [here](https://docs.claude.com/en/api/versioning).
- `x-api-key` string — Your unique API key for authentication. This key is required in the header of all API requests, to authenticate your account and access Anthropic's services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.
- `anthropic-beta` string — Optional header to specify the beta version(s) you want to use. To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.

## Response `200`

Successful Response

- ListResponseModelInfo
  - `data` ModelInfo[], required
    - `created_at` string, date-time, required — RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
    - `display_name` string, required — A human-readable name for the model.
    - `id` string, required — Unique model identifier.
    - `type` 'model', required — Object type. For Models, this is always `"model"`.
  - `first_id` string, nullable, required — First ID in the `data` list. Can be used as the `before_id` for the previous page.
  - `has_more` boolean, required — Indicates if there are more results in the requested page direction.
  - `last_id` string, nullable, required — Last ID in the `data` list. Can be used as the `after_id` for the next page.

## Other responses

- `4XX` — Error response. See our [errors documentation](https://docs.claude.com/en/api/errors) for more details.

---

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