---
title: "List all skills"
method: GET
path: "/api/v2/skills"
tags: ["Skills"]
---

# List all skills

`GET /api/v2/skills`

> 🔑
>
> Required OAuth scope: `skills:read`.

> 📖
>
> This endpoint is paginated with a page size of 500 skills. For more information, see the [Pagination guide](https://360learning.readme.io/docs/pagination).

Lists all skills in your platform.

## Query parameters

- `status` object
  - `eq` 'archived' | 'published' — Filter on values equal to the given one
  - `ne` 'archived' | 'published' — Filter on values not equal to the given one
  - `in` string[] — Filter on values including the given ones
  - `nin` string[] — Filter on values excluding the given ones
- `updatedAt` object
  - `lt` string, date-time — Filter on dates lower than the given one
  - `gte` string, date-time — Filter on dates greater than or equal the given one

## Headers

- `360-api-version` 'v2.0', required

## Response `200`

Returns one page of 500 skills.

- SkillDTO[]
  - `_id` string, required — The unique ID of the skill.
  - `name` string, required — The name of the skill.
  - `parents` SkillParentDTO[], required — The parent skills and libraries.
    - `_id` string, required — The unique ID of the parent.
    - `externalId` string — The unique external ID of the parent.
  - `status` 'archived' | 'published', required — The status of the skill.
  - `translations` SkillTranslationDTO[], required — The different translations available for the skill.
    - `lang` 'bg' | 'cs' | 'de' | 'en' | 'es' | 'fr' | 'hu' | 'it' | 'ja' | 'nl' | 'pl' | 'pt' | 'ro' | 'ru' | 'sa' | 'tr' | 'uk' | 'vm' | 'zh', required — The language of the translation.
    - `translatedFields` SkillTranslatedFieldsDTO, required
      - `name` string — The translation of the field `name` for this language.
      - `description` string — The translation of the field `description` for this language.
  - `externalId` string — The unique external ID of the skill.
  - `description` string — The description of the skill.
  - `libraryId` string — The ID of the library that contains the skill.
  - `createdAt` string, date-time — The creation date of the skill, in the `YYYY-MM-DDThh:mm:ss.sssZ` format (ISO 8601 in Coordinated Universal Time (UTC)).
  - `updatedAt` string, date-time — The last update date of the skill, in the `YYYY-MM-DDThh:mm:ss.sssZ` format (ISO 8601 in Coordinated Universal Time (UTC)).

## Other responses

- `400` — The skill solution is not enabled.
- `401` — The given access token is either missing, invalid, has expired, or has been revoked.
- `403` — The given access token does not have the required OAuth scope to execute the request.
- `429` — The client has sent too many requests in a short amount of time.

---

[API](https://skmtc.net/360learning/apis/core-api.md) · [All operations](https://skmtc.net/360learning/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/360learning/core-api/revisions/94b691b0b72c/schema)