Repository Public
1---2title: List Models3url: https://platform.claude.com/docs/en/api/models/list4---56# List Models78**GET** `/v1/models`910List available models.1112The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.1314## Query parameters1516- `after_id: optional string`1718 ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.1920- `before_id: optional string`2122 ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.2324- `limit: optional number`2526 Number of items to return per page.2728 Defaults to `20`. Ranges from `1` to `1000`.2930 default: 20, maximum: 1000, minimum: 13132## Headers3334- `"anthropic-beta": optional array of AnthropicBeta`3536 Optional header to specify the beta version(s) you want to use.3738 - `string`3940 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`4142 - `"message-batches-2024-09-24"`4344 - `"prompt-caching-2024-07-31"`4546 - `"computer-use-2024-10-22"`4748 - `"computer-use-2025-01-24"`4950 - `"pdfs-2024-09-25"`5152 - `"token-counting-2024-11-01"`5354 - `"token-efficient-tools-2025-02-19"`5556 - `"output-128k-2025-02-19"`5758 - `"files-api-2025-04-14"`5960 - `"mcp-client-2025-04-04"`6162 - `"mcp-client-2025-11-20"`6364 - `"dev-full-thinking-2025-05-14"`6566 - `"interleaved-thinking-2025-05-14"`6768 - `"code-execution-2025-05-22"`6970 - `"extended-cache-ttl-2025-04-11"`7172 - `"context-1m-2025-08-07"`7374 - `"context-management-2025-06-27"`7576 - `"model-context-window-exceeded-2025-08-26"`7778 - `"skills-2025-10-02"`7980 - `"fast-mode-2026-02-01"`8182 - `"output-300k-2026-03-24"`8384 - `"user-profiles-2026-03-24"`8586 - `"user-profiles-2026-08-18"`8788 - `"user-profiles-2026-09-04"`8990 - `"advisor-tool-2026-03-01"`9192 - `"managed-agents-2026-04-01"`9394 - `"cache-diagnosis-2026-04-07"`9596 - `"dreaming-2026-04-21"`9798 - `"thinking-token-count-2026-05-13"`99100 - `"server-side-fallback-2026-06-01"`101102 - `"server-side-fallback-2026-07-01"`103104 - `"fallback-credit-2026-06-01"`105106 - `"fallback-credit-2026-07-01"`107108 - `"agent-memory-2026-07-22"`109110 - `"mid-conversation-tool-changes-2026-07-01"`111112 - `"compact-2026-01-12"`113114 - `"computer-use-2025-11-24"`115116 - `"mcp-tunnels-2026-06-22"`117118 - `"structured-outputs-2025-11-13"`119120 - `"task-budgets-2026-03-13"`121122 - `"thinking-display-updates-2026-08-18"`123124 - `"ce-user-management-2026-07-13"`125126 - `"mid-conversation-output-config-2026-07-01"`127128 - `"thinking-binding-controls-2026-08-01"`129130 - `"mid-conversation-system-clear-at-2026-08-21"`131132 - `"compact-2026-09-04"`133134- `"anthropic-workspace-id": optional string`135136## Returns137138- `data: array of ModelInfo`139140 - `type: "model"`141142 Object type.143144 For Models, this is always `"model"`.145146 default: model147148 - `id: string`149150 Unique model identifier.151152 - `capabilities: ModelCapabilities or null`153154 Model capability information.155156 - `batch: CapabilitySupport`157158 Whether the model supports the Batch API.159160 - `supported: boolean`161162 Whether this capability is supported by the model.163164 - `citations: CapabilitySupport`165166 Whether the model supports citation generation.167168 - `code_execution: CapabilitySupport`169170 Whether the model supports code execution tools.171172 - `context_management: ContextManagementCapability`173174 Context management support and available strategies.175176 - `clear_thinking_20251015: CapabilitySupport or null`177178 Indicates whether a capability is supported.179180 - `clear_tool_uses_20250919: CapabilitySupport or null`181182 Indicates whether a capability is supported.183184 - `compact_20260112: CapabilitySupport or null`185186 Indicates whether a capability is supported.187188 - `supported: boolean`189190 Whether this capability is supported by the model.191192 - `effort: EffortCapability`193194 Effort (reasoning_effort) support and available levels.195196 - `high: CapabilitySupport`197198 Whether the model supports high effort level.199200 - `low: CapabilitySupport`201202 Whether the model supports low effort level.203204 - `max: CapabilitySupport`205206 Whether the model supports max effort level.207208 - `medium: CapabilitySupport`209210 Whether the model supports medium effort level.211212 - `supported: boolean`213214 Whether this capability is supported by the model.215216 - `xhigh: CapabilitySupport or null`217218 Indicates whether a capability is supported.219220 - `image_input: CapabilitySupport`221222 Whether the model accepts image content blocks.223224 - `pdf_input: CapabilitySupport`225226 Whether the model accepts PDF content blocks.227228 - `structured_outputs: CapabilitySupport`229230 Whether the model supports structured output / JSON mode / strict tool schemas.231232 - `thinking: ThinkingCapability`233234 Thinking capability and supported type configurations.235236 - `supported: boolean`237238 Whether this capability is supported by the model.239240 - `types: ThinkingTypes`241242 Supported thinking type configurations.243244 - `adaptive: CapabilitySupport`245246 Whether the model supports thinking with type 'adaptive' (auto).247248 - `enabled: CapabilitySupport`249250 Whether the model supports thinking with type 'enabled'.251252 - `created_at: string`253254 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.255256 format: date-time257258 - `display_name: string`259260 A human-readable name for the model.261262 - `max_input_tokens: number or null`263264 Maximum input context window size in tokens for this model.265266 - `max_tokens: number or null`267268 Maximum value for the `max_tokens` parameter when using this model.269270- `first_id: string or null`271272 First ID in the `data` list. Can be used as the `before_id` for the previous page.273274- `has_more: boolean`275276 Indicates if there are more results in the requested page direction.277278- `last_id: string or null`279280 Last ID in the `data` list. Can be used as the `after_id` for the next page.281282## Example283284```bash285curl https://api.anthropic.com/v1/models \286 -H 'anthropic-version: 2023-06-01' \287 -H "X-Api-Key: $ANTHROPIC_API_KEY"288```289290### Response (200)291292```json293{294 "data": [295 {296 "id": "claude-opus-5",297 "capabilities": {298 "batch": {299 "supported": true300 },301 "citations": {302 "supported": true303 },304 "code_execution": {305 "supported": true306 },307 "context_management": {308 "clear_thinking_20251015": {309 "supported": true310 },311 "clear_tool_uses_20250919": {312 "supported": true313 },314 "compact_20260112": {315 "supported": true316 },317 "supported": true318 },319 "effort": {320 "high": {321 "supported": true322 },323 "low": {324 "supported": true325 },326 "max": {327 "supported": true328 },329 "medium": {330 "supported": true331 },332 "supported": true,333 "xhigh": {334 "supported": true335 }336 },337 "image_input": {338 "supported": true339 },340 "pdf_input": {341 "supported": true342 },343 "structured_outputs": {344 "supported": true345 },346 "thinking": {347 "supported": true,348 "types": {349 "adaptive": {350 "supported": true351 },352 "enabled": {353 "supported": true354 }355 }356 }357 },358 "created_at": "2026-07-24T00:00:00Z",359 "display_name": "Claude Opus 5",360 "max_input_tokens": 0,361 "max_tokens": 0,362 "type": "model"363 }364 ],365 "first_id": "first_id",366 "has_more": true,367 "last_id": "last_id"368}369```370