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

# List Skill Versions

`GET /v1/skills/{skill_id}/versions?beta=true`

## 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 items to return per page. Defaults to `20`. Ranges from `1` to `1000`.

## Headers

- `anthropic-beta` string — Optional header to specify the beta version(s) you want to use. To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.
- `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

- BetaListSkillVersionsResponse
  - `data` BetaSkillVersion[], required — List of skill versions.
    - `created_at` string, required — ISO 8601 timestamp of when the skill version was created.
    - `description` string, required — Description of the skill version. This is extracted from the SKILL.md file in the skill upload.
    - `directory` string, required — Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files.
    - `id` string, required — Unique identifier for the skill version. The format and length of IDs may change over time.
    - `name` string, required — Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload.
    - `skill_id` string, required — Identifier for the skill that this version belongs to.
    - `type` string, required — Object type. For Skill Versions, this is always `"skill_version"`.
    - `version` string, required — Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
  - `has_more` boolean, required — Indicates if there are more results in the requested page direction.
  - `next_page` string, nullable, required — Token to provide in as `page` in the subsequent request to retrieve the next page of data.

## 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/versions/93d8fd7d6493/schema)