---
title: "List Skills"
method: GET
path: "/v1/skills?beta=true"
---

# List Skills

`GET /v1/skills?beta=true`

## Query parameters

- `page` string, nullable — Pagination token for fetching a specific page of results. Pass the value from a previous response's `next_page` field to get the next page of results.
- `limit` integer — Number of results to return per page. Maximum value is 100. Defaults to 20.
- `source` string, nullable — Filter skills by source. If provided, only skills from the specified source will be returned: * `"custom"`: only return user-created skills * `"anthropic"`: only return Anthropic-created skills

## 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

- BetaListSkillsResponse
  - `data` BetaGetSkillResponse[], required — List of skills.
    - `created_at` string, required — ISO 8601 timestamp of when the skill was created.
    - `display_title` string, nullable, required — Display title for the skill. This is a human-readable label that is not included in the prompt sent to the model.
    - `id` string, required — Unique identifier for the skill. The format and length of IDs may change over time.
    - `latest_version` string, nullable, required — The latest version identifier for the skill. This represents the most recent version of the skill that has been created.
    - `source` string, required — Source of the skill. This may be one of the following values: * `"custom"`: the skill was created by a user * `"anthropic"`: the skill was created by Anthropic
    - `type` string, required — Object type. For Skills, this is always `"skill"`.
    - `updated_at` string, required — ISO 8601 timestamp of when the skill was last updated.
  - `has_more` boolean, required — Whether there are more results available. If `true`, there are additional results that can be fetched using the `next_page` token.
  - `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)