List Models
models.list(**kwargs) -> Page<ModelInfo { id, created_at, display_name, type } >
/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.
Parameters
after_id: 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: String
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
limit: Integer
Number of items to return per page.
Defaults to 20. Ranges from 1 to 1000.
maximum1000
minimum1
Returns
List Models
Ruby
require "anthropic"
anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key")
page = anthropic.models.list
puts(page){
"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"
}