---
title: "Список писем"
method: GET
path: "/emails"
tags: ["Email"]
---

# Список писем

`GET /emails`

Возвращает постраничный список отправленных или ожидающих отправки писем.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Список писем.

- object
  - `emails` Email[], required — Список email-сообщений.
    - `uuid` string, uuid, required — UUID в стандартном строковом формате.
    - `status` 'waiting' | 'sended' | 'delivered' | 'failed', required — Статус письма.
    - `created` string, nullable, required — Дата создания письма.
    - `sended` string, nullable — Дата отправки письма.
    - `delivered` string, nullable — Дата доставки письма.
    - `tags` string[], required — Уникальные slug-метки.
    - `from_name` string, required — Имя отправителя.
    - `from_email` string, email, required — Email отправителя.
    - `email` string, email, required — Email получателя.
    - `subject` string, required — Тема письма.
  - `next` integer — Номер следующей страницы, если есть продолжение списка.

## Other responses

- `400` — Неправильный запрос.
- `401` — Пользователь не авторизован или токен не передан.
- `403` — Доступ запрещен.
- `500` — Внутренняя ошибка сервера.

---

[API](https://skmtc.dev/smartofood/apis/smartofood-control-api.md) · [All operations](https://skmtc.dev/smartofood/apis/smartofood-control-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smartofood/smartofood-control-api/revisions/50489dff6853/schema)