from line 1
1---
2title: Models
3url: https://platform.claude.com/docs/en/api/beta/models
4---
5
61# Models
72
83## List Models
94
10**get** `/v1/models`
5**GET** `/v1/models`
116
127List available models.
138
149The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
1510
16### Query Parameters
11### Query parameters
1712
1813- `after_id: optional string`
1914
from line 24
2924
3025 Defaults to `20`. Ranges from `1` to `1000`.
3126
32### Header Parameters
27 default: 20, maximum: 1000, minimum: 1
3328
29### Headers
30
3431- `"anthropic-beta": optional array of AnthropicBeta`
3532
3633 Optional header to specify the beta version(s) you want to use.
from line 220
223220
224221 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.
225222
223 format: date-time
224
226225 - `display_name: string`
227226
228227 A human-readable name for the model.
from line 240
241240
242241 For Models, this is always `"model"`.
243242
244 - `"model"`
243 default: model
245244
246245- `first_id: string or null`
247246
from line 256
257256
258257### Example
259258
260```http
259```bash
261260curl https://api.anthropic.com/v1/models \
262261 -H 'anthropic-version: 2023-06-01' \
263262 -H "X-Api-Key: $ANTHROPIC_API_KEY"
264263```
265264
266#### Response
265#### Response (200)
267266
268267```json
269268{
from line 348
349348
350349## Get a Model
351350
352**get** `/v1/models/{model_id}`
351**GET** `/v1/models/{model_id}`
353352
354353Get a specific model.
355354
356355The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
357356
358### Path Parameters
357### Path parameters
359358
360359- `model_id: string`
361360
362361 Model identifier or alias.
363362
364### Header Parameters
363### Headers
365364
366365- `"anthropic-beta": optional array of AnthropicBeta`
367366
from line 440
441440
442441### Returns
443442
444- `BetaModelInfo object { id, allowed_fallback_models, capabilities, 5 more }`
443- `BetaModelInfo object`
445444
446445 - `id: string`
447446
from line 554
555554
556555 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.
557556
557 format: date-time
558
558559 - `display_name: string`
559560
560561 A human-readable name for the model.
from line 574
573574
574575 For Models, this is always `"model"`.
575576
576 - `"model"`
577 default: model
577578
578579### Example
579580
580```http
581```bash
581582curl https://api.anthropic.com/v1/models/$MODEL_ID \
582583 -H 'anthropic-version: 2023-06-01' \
583584 -H "X-Api-Key: $ANTHROPIC_API_KEY"
584585```
585586
586#### Response
587#### Response (200)
587588
588589```json
589590{
from line 661
660661}
661662```
662663
663## Domain Types
664## Domain types
664665
665666### Beta Capability Support
666667
667- `BetaCapabilitySupport object { supported }`
668- `BetaCapabilitySupport object`
668669
669670 Indicates whether a capability is supported.
670671
from line 675
674675
675676### Beta Context Management Capability
676677
677- `BetaContextManagementCapability object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
678- `BetaContextManagementCapability object`
678679
679680 Context management capability details.
680681
from line 701
700701
701702### Beta Effort Capability
702703
703- `BetaEffortCapability object { high, low, max, 3 more }`
704- `BetaEffortCapability object`
704705
705706 Effort (reasoning_effort) capability details.
706707
from line 735
734735
735736### Beta Model Capabilities
736737
737- `BetaModelCapabilities object { batch, citations, code_execution, 6 more }`
738- `BetaModelCapabilities object`
738739
739740 Model capability information.
740741
from line 837
836837
837838### Beta Model Info
838839
839- `BetaModelInfo object { id, allowed_fallback_models, capabilities, 5 more }`
840- `BetaModelInfo object`
840841
841842 - `id: string`
842843
from line 951
950951
951952 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.
952953
954 format: date-time
955
953956 - `display_name: string`
954957
955958 A human-readable name for the model.
from line 971
968971
969972 For Models, this is always `"model"`.
970973
971 - `"model"`
974 default: model
972975
973976### Beta Thinking Capability
974977
975- `BetaThinkingCapability object { supported, types }`
978- `BetaThinkingCapability object`
976979
977980 Thinking capability details.
978981
from line 1001
9981001
9991002### Beta Thinking Types
10001003
1001- `BetaThinkingTypes object { adaptive, enabled }`
1004- `BetaThinkingTypes object`
10021005
10031006 Supported thinking type configurations.
10041007
No line in this hunk matches that.