---
title: "List Skill Versions"
method: GET
path: "/v1/skills/{skill_id}/versions"
---

# List Skill Versions

`GET /v1/skills/{skill_id}/versions`

## Path parameters

- `skill_id` string, required — Unique identifier for the skill. The format and length of IDs may change over time.

## Query parameters

- `page` string, nullable — Optionally set to the `next_page` token from the previous response.
- `limit` integer, nullable — Number of results to return per page. Ranges from `1` to `1000`. Defaults to `20`.

## Headers

- `anthropic-version` string — The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).
- `x-api-key` string — Your unique API key for authentication. This key is required in the header of all API requests, to authenticate your account and access Anthropic's services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.

## Response `200`

Successful Response

- ListSkillVersionsResponse
  - `data` SkillVersion[], required — List of skills.
    - `created_at` string, date-time, required — ISO 8601 timestamp of when the skill was created.
    - `description` string, required — Description of the skill version. This is extracted from the SKILL.md file in the skill upload.
    - `id` string, required — Unique identifier for this Skill Version. The id addresses the version in paths and pins it in references.
    - `name` string, required — The Skill's immutable kebab-case slug, set at creation from the first upload's SKILL.md frontmatter `name` (or its enclosing directory). Every later upload must resolve to the same value. Also the top-level directory of the Skill's mounted files and the base name of a downloaded archive.
    - `skill_id` string, required — Unique identifier for the skill. The format and length of IDs may change over time.
    - `type` 'skill_version', required — Object type. For Skill Versions, this is always `"skill_version"`.
  - `next_page` string, nullable, required — Token for fetching the next page of results. If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.

## Other responses

- `4XX` — Error response. See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.

---

[API](https://skmtc.net/anthropics/apis/anthropic-api.md) · [All operations](https://skmtc.net/anthropics/apis/anthropic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anthropics/anthropic-api/revisions/0042750ea1ee/schema)