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

# List all the powers

`GET /api/v2/skills/powers`

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

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

Lists all the powers.

## Query parameters

- `skillId` object
  - `eq` string — Filter on values equal to the given one
  - `in` string[] — Filter on values including the given ones
- `status` object
  - `eq` 'toAssess' | 'pendingValidation' | 'validated' — Filter on values equal to the given one
  - `ne` 'toAssess' | 'pendingValidation' | 'validated' — Filter on values not equal to the given one
- `userId` object
  - `eq` string, ObjectId — Filter on values equal to the given one
  - `in` string[] — Filter on values including the given ones

## Headers

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

## Response `200`

Returns one page of 500 powers.

- PowerDTO[]
  - `_id` string, required — The unique ID of the power.
  - `externalId` string — The unique external ID of the power.
  - `skillId` string, required — The unique ID of the skill.
  - `skillExternalId` string — The unique external ID of the skill.
  - `userId` string, ObjectId, required — The unique ID of the user.
  - `createdAt` string, date-time — The date and time when the power was created, in the `YYYY-MM-DDThh:mm:ss.sssZ` format (ISO 8601 in Coordinated Universal Time (UTC)).
  - `updatedAt` string, date-time — The date and time when the power was last updated, in the `YYYY-MM-DDThh:mm:ss.sssZ` format (ISO 8601 in Coordinated Universal Time (UTC)).
  - `status` 'toAssess' | 'pendingValidation' | 'validated', required — The status of the power.
  - `qualifiers` union[], required — The list of qualifiers of the power.
    - union
      - SingleChoiceQualifierDTO
        - `_id` string, required — The unique ID of the qualifier.
        - `type` 'singleChoice' — The type of the qualifier.
        - `currentValue` string — The current value of the qualifier.
        - `currentValueId` string — The unique ID of the current value of the qualifier.
      - MultiChoiceQualifierDTO
        - `_id` string, required — The unique ID of the qualifier.
        - `type` 'multiChoice' — The type of the qualifier.
        - `currentValues` string[] — The list of the current values of the qualifier.
        - `currentValueIds` string[] — The list of current values unique IDs of the qualifier.
      - TextQualifierDTO
        - `_id` string, required — The unique ID of the qualifier.
        - `type` 'text' — The type of the qualifier.
        - `currentValue` string — The current value of the qualifier.
      - NumberQualifierDTO
        - `_id` string, required — The unique ID of the qualifier.
        - `type` 'number' — The type of the qualifier.
        - `currentValue` number — The current value of the qualifier.
      - DateQualifierDTO
        - `_id` string, required — The unique ID of the qualifier.
        - `type` 'date' — The type of the qualifier.
        - `currentValue` string, date-time — The current value of the qualifier, 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)