# DashaMail REST API v2: GET /v2/lists — Адресные базы

В `response.data` — базы с полями `id`, `state`, `name`, `merge_1`…`merge_N` и счётчиками `count_active`, `count_unsubscribed`, `count_all` и др.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `state` | query | string | нет | active, archived, blocked |
| `limit` | query | integer | нет | Число баз; без него — все |
| `offset` | query | integer | нет | Смещение (только с limit) |
| `merge_json` | query | boolean | нет | Описания доп. полей в JSON |

## Базовые URL

- Боевой: `https://api.dashamail.com`
- Ресурсы: `/v2`

## Авторизация

Тип: Bearer-токен

API-ключ из личного кабинета передаётся в заголовке `Authorization: Bearer <ключ>` (схема `ApiKey` тоже принимается). Для совместимости ключ можно передать параметром `api_key` в строке запроса — менее безопасно; при заданном заголовке параметр игнорируется.

```
curl 'https://api.dashamail.com/v2/lists' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

## Нюансы

- Перед запуском рассылки проверяются тема, отправитель, наличие HTML или текста, ссылка отписки (`id="unsub_link"` в HTML или `%ОТПИСАТЬСЯ%` в тексте) и баланс.
- Домен `from_email` должен быть добавлен и подтверждён (DKIM, SPF), иначе письма не уйдут (код 34).
- Ответы — JSON с `response.data`; журнал и статистика транзакционных писем — `GET /v2/transactional/log` и `GET /v2/transactional/stats`.
- Разделы API: `/lists`, `/campaigns`, `/automations`, `/templates`, `/reports`, `/transactional`, `/account`, `/router`.

## Сценарии с этим методом

- [Добавить подписчика в адресную базу](https://mcp-everything.ru/integrations/dashamail/scenarios/dobavit-podpischika-v-adresnuyu-bazu.md)

---

Если этого недостаточно — официальная документация: https://dashamail.ru/api/
Вся интеграция одним документом: https://mcp-everything.ru/integrations/dashamail.md