Get a Model
api/models/retrieve
Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
api/models/retrieve Changed · +16 / -19 lines
# Get a Model ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Get a Model ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
---- -title: Get a Model -url: https://platform.claude.com/docs/en/api/models/retrieve ---- +# Get a Model -## Get a Model +**GET** `/v1/models/{model_id}` -**get** `/v1/models/{model_id}` - 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. -### Path Parameters +## Path parameters - `model_id: string` Model identifier or alias. -### Header Parameters +## Headers - `"anthropic-beta": optional array of AnthropicBeta`
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns +## Returns -- `ModelInfo object { id, capabilities, created_at, 4 more }` +- `ModelInfo object` - `id: 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. + format: date-time + - `display_name: string` A human-readable name for the model.
For Models, this is always `"model"`. - - `"model"` + default: model -### Example +## Example -```http +```bash curl https://api.anthropic.com/v1/models/$MODEL_ID \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +### Response (200) ```json {