ANanthropics

List Models

Changed on

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.

get/v1/models

Request

  • Base URL
    https://api.anthropic.com
  • Auth
    none declared

Query parameters

before_idstring

ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.

after_idstring

ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.

limitinteger

Number of items to return per page.

Defaults to 20. Ranges from 1 to 1000.

lifecycle[]string[]

Filter the list to models in any of the given lifecycle stages (active, deprecated, or retired). Up to 3 values. When omitted, the list contains the active and deprecated models; retired models appear only when retired is requested explicitly.

Headers

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

anthropic-workspace-idstring

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Response

Successful Response

first_idstring nullable required

First ID in the data list. Can be used as the before_id for the previous page.

has_moreboolean required

Indicates if there are more results in the requested page direction.

last_idstring nullable required

Last ID in the data list. Can be used as the after_id for the next page.

Example response

{
  "data": [
    {
      "created_at": "2026-09-21T00:00:00Z",
      "display_name": "Claude Opus 5.5",
      "id": "claude-opus-5-5",
      "line": "opus"
    }
  ]
}

Changes

  • 94c83daca660Revision changes
    • warning

      deleted the header request parameter x-api-key

    • info

      deleted the header request parameter anthropic-beta with deprecation

  • b6f3fef9c0b5Revision changes
    • info

      added the enum value webhooks-2026-10-07 to the property items/anyOf[subschema #2]/ of the header request parameter anthropic-beta