Loading...
    • Developer Guide
    • API Reference
    • MCP
    • Resources
    • Release Notes
    Search...
    ⌘K
    Using the API
    API overviewBeta headersErrors
    Messages
    Create a Message
    Count tokens in a Message
    Models
    List Models
    Get a Model
    Beta
    List Models
    Get a Model
    Admin
    Completions
    Create a Text Completion
    Support & configuration
    Rate limitsService tiersVersionsIP addressesSupported regionsOpenAI SDK compatibility
    Console
    Log in

    List Models

    beta.models.list(ModelListParams**kwargs) -> SyncPage[BetaModelInfo]
    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.

    ParametersExpand Collapse
    after_id: Optional[str]

    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[str]

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

    limit: Optional[int]

    Number of items to return per page.

    Defaults to 20. Ranges from 1 to 1000.

    maximum1000
    minimum1
    betas: Optional[List[AnthropicBetaParam]]

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

    Accepts one of the following:
    str
    Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]
    Accepts one of the following:
    "message-batches-2024-09-24"
    "prompt-caching-2024-07-31"
    "computer-use-2024-10-22"
    "computer-use-2025-01-24"
    "pdfs-2024-09-25"
    "token-counting-2024-11-01"
    "token-efficient-tools-2025-02-19"
    "output-128k-2025-02-19"
    "files-api-2025-04-14"
    "mcp-client-2025-04-04"
    "mcp-client-2025-11-20"
    "dev-full-thinking-2025-05-14"
    "interleaved-thinking-2025-05-14"
    "code-execution-2025-05-22"
    "extended-cache-ttl-2025-04-11"
    "context-1m-2025-08-07"
    "context-management-2025-06-27"
    "model-context-window-exceeded-2025-08-26"
    "skills-2025-10-02"
    "fast-mode-2026-02-01"
    ReturnsExpand Collapse
    class BetaModelInfo: …
    id: str

    Unique model identifier.

    capabilities: Optional[BetaModelCapabilities]

    Model capability information.

    batch: BetaCapabilitySupport

    Whether the model supports the Batch API.

    supported: bool

    Whether this capability is supported by the model.

    citations: BetaCapabilitySupport

    Whether the model supports citation generation.

    supported: bool

    Whether this capability is supported by the model.

    code_execution: BetaCapabilitySupport

    Whether the model supports code execution tools.

    supported: bool

    Whether this capability is supported by the model.

    context_management: BetaContextManagementCapability

    Context management support and available strategies.

    clear_thinking_20251015: Optional[BetaCapabilitySupport]

    Indicates whether a capability is supported.

    supported: bool

    Whether this capability is supported by the model.

    clear_tool_uses_20250919: Optional[BetaCapabilitySupport]

    Indicates whether a capability is supported.

    supported: bool

    Whether this capability is supported by the model.

    compact_20260112: Optional[BetaCapabilitySupport]

    Indicates whether a capability is supported.

    supported: bool

    Whether this capability is supported by the model.

    supported: bool

    Whether this capability is supported by the model.

    effort: BetaEffortCapability

    Effort (reasoning_effort) support and available levels.

    high: BetaCapabilitySupport

    Whether the model supports high effort level.

    supported: bool

    Whether this capability is supported by the model.

    low: BetaCapabilitySupport

    Whether the model supports low effort level.

    supported: bool

    Whether this capability is supported by the model.

    max: BetaCapabilitySupport

    Whether the model supports max effort level.

    supported: bool

    Whether this capability is supported by the model.

    medium: BetaCapabilitySupport

    Whether the model supports medium effort level.

    supported: bool

    Whether this capability is supported by the model.

    supported: bool

    Whether this capability is supported by the model.

    image_input: BetaCapabilitySupport

    Whether the model accepts image content blocks.

    supported: bool

    Whether this capability is supported by the model.

    pdf_input: BetaCapabilitySupport

    Whether the model accepts PDF content blocks.

    supported: bool

    Whether this capability is supported by the model.

    structured_outputs: BetaCapabilitySupport

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

    supported: bool

    Whether this capability is supported by the model.

    thinking: BetaThinkingCapability

    Thinking capability and supported type configurations.

    supported: bool

    Whether this capability is supported by the model.

    types: BetaThinkingTypes

    Supported thinking type configurations.

    adaptive: BetaCapabilitySupport

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

    supported: bool

    Whether this capability is supported by the model.

    enabled: BetaCapabilitySupport

    Whether the model supports thinking with type 'enabled'.

    supported: bool

    Whether this capability is supported by the model.

    created_at: datetime

    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: str

    A human-readable name for the model.

    max_input_tokens: Optional[int]

    Maximum input context window size in tokens for this model.

    max_tokens: Optional[int]

    Maximum value for the max_tokens parameter when using this model.

    type: Literal["model"]

    Object type.

    For Models, this is always "model".

    List Models
    import os
    from anthropic import Anthropic
    
    client = Anthropic(
        api_key=os.environ.get("ANTHROPIC_API_KEY"),  # This is the default and can be omitted
    )
    page = client.beta.models.list()
    page = page.data[0]
    print(page.id)
    Response 200
    {
      "data": [
        {
          "id": "claude-opus-4-6",
          "capabilities": {
            "batch": {
              "supported": true
            },
            "citations": {
              "supported": true
            },
            "code_execution": {
              "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
            },
            "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-02-04T00:00:00Z",
          "display_name": "Claude Opus 4.6",
          "max_input_tokens": 0,
          "max_tokens": 0,
          "type": "model"
        }
      ],
      "first_id": "first_id",
      "has_more": true,
      "last_id": "last_id"
    }
    Returns Examples
    Response 200
    {
      "data": [
        {
          "id": "claude-opus-4-6",
          "capabilities": {
            "batch": {
              "supported": true
            },
            "citations": {
              "supported": true
            },
            "code_execution": {
              "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
            },
            "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-02-04T00:00:00Z",
          "display_name": "Claude Opus 4.6",
          "max_input_tokens": 0,
          "max_tokens": 0,
          "type": "model"
        }
      ],
      "first_id": "first_id",
      "has_more": true,
      "last_id": "last_id"
    }

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy