from line 1
1---
2title: List Skill Versions
3url: https://platform.claude.com/docs/en/api/beta/skills/versions/list
4---
1# List Skill Versions
52
6## List Skill Versions
3**GET** `/v1/skills/{skill_id}/versions`
74
8**get** `/v1/skills/{skill_id}/versions`
9
105List Skill Versions
116
12### Path Parameters
7## Path parameters
138
149- `skill_id: string`
1510
from line 12
1712
1813 The format and length of IDs may change over time.
1914
20### Query Parameters
15## Query parameters
2116
2217- `limit: optional number`
2318
from line 24
2924
3025 Optionally set to the `next_page` token from the previous response.
3126
32### Header Parameters
27## Headers
3328
3429- `"anthropic-beta": optional array of AnthropicBeta`
3530
from line 102
107102
108103 - `"mid-conversation-tool-changes-2026-07-01"`
109104
110### Returns
105## Returns
111106
112- `data: array of object { id, created_at, description, 5 more }`
107- `data: array of object`
113108
114109 List of skill versions.
115110
from line 146
151146
152147 For Skill Versions, this is always `"skill_version"`.
153148
149 default: skill_version
150
154151 - `version: string`
155152
156153 Version identifier for the skill.
from line 162
165162
166163 Token to provide in as `page` in the subsequent request to retrieve the next page of data.
167164
168### Example
165## Example
169166
170```http
167```bash
171168curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
172169 -H 'anthropic-version: 2023-06-01' \
173170 -H 'anthropic-beta: skills-2025-10-02' \
from line 171
174171 -H "X-Api-Key: $ANTHROPIC_API_KEY"
175172```
176173
177#### Response
174### Response (200)
178175
179176```json
180177{
No line in this hunk matches that.