ANanthropics

Get a Model

Changed on

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}

Request

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

Path parameters

model_idstring required

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.

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

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.

deprecated_atstring date-time nullable required

RFC 3339 datetime string representing the time of the model's most recent deprecation. Populated for deprecated and retired models; null while the model is active.

display_namestring required

A human-readable name for the model.

idstring required

Unique model identifier.

lifecycle'active' | 'deprecated' | 'retired' required

The model's current lifecycle stage.

  • active: The model is available for use, open to new adopters, and not scheduled for retirement.
  • deprecated: The model remains callable for organizations with existing access, but is headed for retirement and closed to new adopters.
  • retired: The model is no longer available for use; inference requests naming it fail. It remains in the catalogue as the historical record of its retirement.
line'haiku' | 'sonnet' | 'opus' | 'fable' | 'mythos' required

A Claude model line, such as opus or sonnet. More lines may be added as new values.

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.

retires_atstring date-time nullable required

RFC 3339 datetime string representing the model's currently scheduled retirement date. The schedule can be revised until retirement occurs; null while the model is active or while no retirement is scheduled. A past date on a deprecated model means retirement is overdue, not that it has occurred: lifecycle is the retirement signal.

type'model' required

Object type.

For Models, this is always "model".

Example response

{
  "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