from line 1
1---
2title: Models
3url: https://platform.claude.com/docs/en/api/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 216
219216
220217 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.
221218
219 format: date-time
220
222221 - `display_name: string`
223222
224223 A human-readable name for the model.
from line 236
237236
238237 For Models, this is always `"model"`.
239238
240 - `"model"`
239 default: model
241240
242241- `first_id: string or null`
243242
from line 252
253252
254253### Example
255254
256```http
255```bash
257256curl https://api.anthropic.com/v1/models \
258257 -H 'anthropic-version: 2023-06-01' \
259258 -H "X-Api-Key: $ANTHROPIC_API_KEY"
260259```
261260
262#### Response
261#### Response (200)
263262
264263```json
265264{
from line 341
342341
343342## Get a Model
344343
345**get** `/v1/models/{model_id}`
344**GET** `/v1/models/{model_id}`
346345
347346Get a specific model.
348347
349348The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
350349
351### Path Parameters
350### Path parameters
352351
353352- `model_id: string`
354353
355354 Model identifier or alias.
356355
357### Header Parameters
356### Headers
358357
359358- `"anthropic-beta": optional array of AnthropicBeta`
360359
from line 433
434433
435434### Returns
436435
437- `ModelInfo object { id, capabilities, created_at, 4 more }`
436- `ModelInfo object`
438437
439438 - `id: string`
440439
from line 543
544543
545544 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.
546545
546 format: date-time
547
547548 - `display_name: string`
548549
549550 A human-readable name for the model.
from line 563
562563
563564 For Models, this is always `"model"`.
564565
565 - `"model"`
566 default: model
566567
567568### Example
568569
569```http
570```bash
570571curl https://api.anthropic.com/v1/models/$MODEL_ID \
571572 -H 'anthropic-version: 2023-06-01' \
572573 -H "X-Api-Key: $ANTHROPIC_API_KEY"
573574```
574575
575#### Response
576#### Response (200)
576577
577578```json
578579{
from line 647
646647}
647648```
648649
649## Domain Types
650## Domain types
650651
651652### Capability Support
652653
653- `CapabilitySupport object { supported }`
654- `CapabilitySupport object`
654655
655656 Indicates whether a capability is supported.
656657
from line 661
660661
661662### Context Management Capability
662663
663- `ContextManagementCapability object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
664- `ContextManagementCapability object`
664665
665666 Context management capability details.
666667
from line 687
686687
687688### Effort Capability
688689
689- `EffortCapability object { high, low, max, 3 more }`
690- `EffortCapability object`
690691
691692 Effort (reasoning_effort) capability details.
692693
from line 721
720721
721722### Model Capabilities
722723
723- `ModelCapabilities object { batch, citations, code_execution, 6 more }`
724- `ModelCapabilities object`
724725
725726 Model capability information.
726727
from line 823
822823
823824### Model Info
824825
825- `ModelInfo object { id, capabilities, created_at, 4 more }`
826- `ModelInfo object`
826827
827828 - `id: string`
828829
from line 933
932933
933934 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.
934935
936 format: date-time
937
935938 - `display_name: string`
936939
937940 A human-readable name for the model.
from line 953
950953
951954 For Models, this is always `"model"`.
952955
953 - `"model"`
956 default: model
954957
955958### Thinking Capability
956959
957- `ThinkingCapability object { supported, types }`
960- `ThinkingCapability object`
958961
959962 Thinking capability details.
960963
from line 983
980983
981984### Thinking Types
982985
983- `ThinkingTypes object { adaptive, enabled }`
986- `ThinkingTypes object`
984987
985988 Supported thinking type configurations.
986989
No line in this hunk matches that.