List Models
/v1/models?beta=true
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
after_id: optional string
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 string
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
limit: optional number
Number of items to return per page.
Defaults to 20. Ranges from 1 to 1000.
maximum1000
minimum1
Header Parameters
Returns
first_id: string
First ID in the data list. Can be used as the before_id for the previous page.
has_more: boolean
Indicates if there are more results in the requested page direction.
last_id: string
Last ID in the data list. Can be used as the after_id for the next page.
List Models
cURL
curl https://api.anthropic.com/v1/models?beta=true \
-H "X-Api-Key: $ANTHROPIC_API_KEY"{
"data": [
{
"id": "claude-sonnet-4-20250514",
"created_at": "2025-02-19T00:00:00Z",
"display_name": "Claude Sonnet 4",
"type": "model"
}
],
"first_id": "first_id",
"has_more": true,
"last_id": "last_id"
}Returns Examples
{
"data": [
{
"id": "claude-sonnet-4-20250514",
"created_at": "2025-02-19T00:00:00Z",
"display_name": "Claude Sonnet 4",
"type": "model"
}
],
"first_id": "first_id",
"has_more": true,
"last_id": "last_id"
}