List Models
api/beta/models/list
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/beta/models/list Changed · +15 / -16 lines
# List Models ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Models ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
---- -title: List Models -url: https://platform.claude.com/docs/en/api/beta/models/list ---- +# List Models -## List Models +**GET** `/v1/models` -**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. -### Query Parameters +## Query parameters - `after_id: optional string`
Defaults to `20`. Ranges from `1` to `1000`. -### Header Parameters + default: 20, maximum: 1000, minimum: 1 +## Headers + - `"anthropic-beta": optional array of AnthropicBeta` Optional header to specify the beta version(s) you want to use.
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns +## Returns - `data: array of BetaModelInfo`
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 - `first_id: string or null`
Last ID in the `data` list. Can be used as the `after_id` for the next page. -### Example +## Example -```http +```bash curl https://api.anthropic.com/v1/models \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +### Response (200) ```json {