Claude Platform Docs

List Models

$ ant beta:models list
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.

Parameters
--after-id: optional string

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

--before-id: optional string

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

--limit: optional number

Query param: Number of items to return per page.

Defaults to 20. Ranges from 1 to 1000.

maximum1000
minimum1
--beta: optional array of AnthropicBeta

Header param: Optional header to specify the beta version(s) you want to use.

--workspace-id: optional string

Header param: 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.

Returns
BetaListResponse_ModelInfo_: object{ data, first_id, has_more, last_id }
data: array of BetaModelInfo { type: "model", id, allowed_fallback_models, 5 more }
type: "model"

Object type.

For Models, this is always "model".

id: string

Unique model identifier.

allowed_fallback_models: array of string

Model IDs this model accepts as fallbacks[i].model on the Messages API. An empty list means the fallbacks parameter is not supported for this model as primary.

capabilities: object{ batch, citations, code_execution, 7 more }

Model capability information.

batch: object{ supported }

Whether the model supports the Batch API.

supported: boolean

Whether this capability is supported by the model.

citations: object{ supported }

Whether the model supports citation generation.

supported: boolean

Whether this capability is supported by the model.

code_execution: object{ supported }

Whether the model supports code execution tools.

supported: boolean

Whether this capability is supported by the model.

compaction: object{ summarize, supported }

Compaction capability details: whether the model accepts the top-level compaction request parameter, with one entry per supported compaction.type value.

summarize: object{ supported }

Whether the summarize compaction type is supported.

supported: boolean

Whether this capability is supported by the model.

supported: boolean

Whether this capability is supported by the model.

context_management: object{ clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }

Context management support and available strategies.

clear_thinking_20251015: object{ supported }

Indicates whether a capability is supported.

supported: boolean

Whether this capability is supported by the model.

clear_tool_uses_20250919: object{ supported }

Indicates whether a capability is supported.

supported: boolean

Whether this capability is supported by the model.

compact_20260112: object{ supported }

Indicates whether a capability is supported.

supported: boolean

Whether this capability is supported by the model.

supported: boolean

Whether this capability is supported by the model.

effort: object{ high, low, max, 3 more }

Effort (reasoning_effort) support and available levels.

high: object{ supported }

Whether the model supports high effort level.

supported: boolean

Whether this capability is supported by the model.

low: object{ supported }

Whether the model supports low effort level.

supported: boolean

Whether this capability is supported by the model.

max: object{ supported }

Whether the model supports max effort level.

supported: boolean

Whether this capability is supported by the model.

medium: object{ supported }

Whether the model supports medium effort level.

supported: boolean

Whether this capability is supported by the model.

supported: boolean

Whether this capability is supported by the model.

xhigh: object{ supported }

Indicates whether a capability is supported.

supported: boolean

Whether this capability is supported by the model.

image_input: object{ supported }

Whether the model accepts image content blocks.

supported: boolean

Whether this capability is supported by the model.

pdf_input: object{ supported }

Whether the model accepts PDF content blocks.

supported: boolean

Whether this capability is supported by the model.

structured_outputs: object{ supported }

Whether the model supports structured output / JSON mode / strict tool schemas.

supported: boolean

Whether this capability is supported by the model.

thinking: object{ supported, types }

Thinking capability and supported type configurations.

supported: boolean

Whether this capability is supported by the model.

types: object{ adaptive, enabled }

Supported thinking type configurations.

adaptive: object{ supported }

Whether the model supports thinking with type 'adaptive' (auto).

supported: boolean

Whether this capability is supported by the model.

enabled: object{ supported }

Whether the model supports thinking with type 'enabled'.

supported: boolean

Whether this capability is supported by the model.

created_at: string

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.

formatdate-time
display_name: string

A human-readable name for the model.

max_input_tokens: number

Maximum input context window size in tokens for this model.

max_tokens: number

Maximum value for the max_tokens parameter when using this model.

first_id: string

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

has_more: boolean

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

last_id: string

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

List Models
ant beta:models list \
  --api-key my-anthropic-api-key
Returns Examples
Response 200
{
  "data": [
    {
      "id": "claude-opus-5",
      "allowed_fallback_models": [
        "string"
      ],
      "capabilities": {
        "batch": {
          "supported": true
        },
        "citations": {
          "supported": true
        },
        "code_execution": {
          "supported": true
        },
        "compaction": {
          "summarize": {
            "supported": true
          },
          "supported": true
        },
        "context_management": {
          "clear_thinking_20251015": {
            "supported": true
          },
          "clear_tool_uses_20250919": {
            "supported": true
          },
          "compact_20260112": {
            "supported": true
          },
          "supported": true
        },
        "effort": {
          "high": {
            "supported": true
          },
          "low": {
            "supported": true
          },
          "max": {
            "supported": true
          },
          "medium": {
            "supported": true
          },
          "supported": true,
          "xhigh": {
            "supported": true
          }
        },
        "image_input": {
          "supported": true
        },
        "pdf_input": {
          "supported": true
        },
        "structured_outputs": {
          "supported": true
        },
        "thinking": {
          "supported": true,
          "types": {
            "adaptive": {
              "supported": true
            },
            "enabled": {
              "supported": true
            }
          }
        }
      },
      "created_at": "2026-07-24T00:00:00Z",
      "display_name": "Claude Opus 5",
      "max_input_tokens": 0,
      "max_tokens": 0,
      "type": "model"
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id"
}