Sign in

Get a Model

Get a specific model.

The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.

get/v1/models/{model_id}?beta=true

Path parameters

model_idstring required

Model identifier or alias.

Model identifier or alias.

Headers

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

The version of the Claude API you want to use.

Read more about versioning and our version history here.

anthropic-betastring

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.

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.

x-api-keystring

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. Each key is scoped to a Workspace.

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. Each key is scoped to a Workspace.

Response

Successful Response

allowed_fallback_modelsstring[] nullable required

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.

created_atstring 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_namestring required

A human-readable name for the model.

idstring required

Unique model identifier.

max_input_tokensinteger nullable required

Maximum input context window size in tokens for this model.

max_tokensinteger nullable required

Maximum value for the max_tokens parameter when using this model.

type'model' required

Object type.

For Models, this is always "model".

Example response

{
  "created_at": "2026-07-24T00:00:00Z",
  "display_name": "Claude Opus 5",
  "id": "claude-opus-5"
}

Changes

Changed in 3 of the 67 revisions of this API.5

  • 00259327305f1See the full diff
    • ○

      added the required property allowed_fallback_models to the response with the 200 status

      response-required-property-added

  • e0696f59ae071See the full diff
    • ○

      added the required property capabilities/anyOf[subschema #1: ModelCapabilities]/effort/xhigh to the response with the 200 status

      response-required-property-added

  • dd2dcd00a7573See the full diff
    • ○

      added the required property capabilities to the response with the 200 status

      response-required-property-added

    • ○

      added the required property max_input_tokens to the response with the 200 status

      response-required-property-added

    • ○

      added the required property max_tokens to the response with the 200 status

      response-required-property-added