---
title: "List all learning needs"
method: GET
path: "/api/v2/learning-needs"
tags: ["Learning Needs"]
---

# List all learning needs

`GET /api/v2/learning-needs`

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

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

Lists all learning needs in your platform.

## Headers

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

## Response `200`

Returns one page of 500 learning needs.

- LearningNeedDTO[]
  - `_id` string, ObjectId, required — The unique ID of the learning need.
  - `groupId` string, ObjectId, required — The unique ID of the group the learning need belongs to.
  - `name` string, required — The name of the learning need.
  - `status` 'new' | 'exploring' | 'onHold' | 'projectOngoing' | 'done' | 'alreadyExists' | 'discarded', required — The status of the learning need.
  - `createdAt` string, date-time, required — The date when the learning need was created.
  - `authorId` string, ObjectId, required — The unique ID of the user who declared the learning need.
  - `questions` Question[], required — The questions associated with the learning need.
    - `title` string, required — The title of the question.
    - `answer` string — The answer to the question.
  - `suggestedExpertIds` string[], required — The unique IDs of the suggested experts for the learning need.
  - `volunteerIds` string[], required — The unique IDs of the users that volunteered for this learning need.

## Other responses

- `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)