---
title: "Получить список"
method: GET
path: "/api-v2/projects"
tags: ["Проекты"]
---

# Получить список

`GET /api-v2/projects`

## Request

- Base URL: `https://api-docs.yougile.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.yougile.com/api-v2/projects`
- Auth: HTTP bearer

## Query parameters

- `includeDeleted` boolean
- `limit` number
- `offset` number
- `title` string

## Response `200`

- ProjectListDto
  - `paging` PagingMetadata, required
    - `count` number, required: Количество элементов в результате
    - `limit` number, required: Количество элементов на страницу
    - `offset` number, required: Индекс первого элемента страницы
    - `next` boolean, required: Есть ли элементы после данной страницы
  - `content` ProjectListDtoBase[], required: Список проектов
    - `deleted` boolean: Если true, значит объект удален
    - `id` string, required: ID объекта
    - `title` string, required: Название проекта
    - `timestamp` number, required: Время создания проекта
    - `users` object: Сотрудники на проекте и их роль. Возможные значения: <br/><div>1) системные роли: worker, admin, observer</div><div>2) ID пользовательской роли</div><div>3) "-" для удаления существующего пользователя из проекта</div><div>Нельзя изменять роли пользователей, получивших доступ через отдел</div>
    - `departments` object: Отделы на проекте и маппинг ролей. Возможные значения: <br/><div>1) объект с manager и member</div><div>2) "-" для удаления привязки отдела</div>

## Other responses

- `404`

---

[API](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0.md) - [All operations](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0/revisions/9452cba35716?raw)