---
title: "Получить папки ящика"
method: GET
path: "/api/v1/mail/accounts/{id}/folders"
tags: ["Mail accounts"]
---

# Получить папки ящика

`GET /api/v1/mail/accounts/{id}/folders`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/mail/accounts/{id}/folders`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Роль папки — наше прочтение её назначения, а не имя на сервере: экран и правила работают с ролью, синхронизация — с внешним именем.

## Response `200`

Папки ящика в привычном порядке системных папок

- object
  - `items` MailFolder[], required
    - `id` string, uuid, required
    - `account_id` string, uuid, required
    - `external_id` string, required: Идентификатор папки у провайдера; локальная папка «Исходящие» использует внутренний идентификатор и не синхронизируется по IMAP
    - `name` string, required
    - `role` 'inbox' | 'outbox' | 'sent' | 'drafts' | 'trash' | 'spam' | 'archive' | 'custom', required: Назначение папки в нашем прочтении, а не её имя на сервере. Незнакомое имя остаётся custom — угаданная роль складывала бы туда отправленные письма.
    - `parent_id` string, uuid, required
    - `delimiter` string, required: Разделитель иерархии, который назвал сервер
    - `total_count` integer, required
    - `unread_count` integer, required
    - `sort_order` integer, required: Вес папки в привычном порядке системных папок
    - `subscribed` boolean, required
    - `mirror` boolean, required: Вид на ту же почту (Gmail «Вся почта», «Важное», «Помеченные»): письма в нём — копии писем из настоящих папок, в сводные выборки они не попадают
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/a99574d597cc?raw)