Рассылки

Получатели рассылки по статусам

Постраничный список получателей рассылки с фильтром по статусам доставки и активности. Каждому получателю присваивается ровно один статус по приоритету: complaint > unsubscribed > hard_bounced > soft_bounced > error > clicked > error_infrastructure > opened > delivered > not_delivered. То есть clicked включает opened (кликнувший получатель не попадёт в выборку opened), а unsubscribed и complaint перекрывают остальные статусы. Точное количество страниц не возвращается — используйте hasMore для навигации. Для статусов error, soft_bounced, hard_bounced возвращается ответ SMTP-сервера (responseSmtp).

get/v1/public/campaigns/{campaignId}/recipients

Request

  • Base URL: https://api.rusender.ru/api
  • URL: https://api.rusender.ru/api/v1/public/campaigns/{campaignId}/recipients
  • Auth: HTTP bearer

Path parameters

campaignIdinteger required

ID рассылки.

Query parameters

statusstring[]

Фильтр по статусам получателя (через запятую). Каждый получатель имеет ровно один статус по приоритету: complaint > unsubscribed > hard_bounced > soft_bounced > error > clicked > error_infrastructure > opened > delivered > not_delivered.

Response

Страница получателей рассылки.

okboolean required

Флаг успешного выполнения.

Example response

{
  "ok": true,
  "data": {
    "items": [
      {
        "contactId": 123,
        "email": "user@example.com",
        "status": "opened",
        "responseSmtp": "550 5.1.1 User unknown"
      }
    ],
    "hasMore": true
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-03-05T12:00:00.000Z",
    "pagination": {
      "page": 1,
      "limit": 20,
      "totalItems": 150,
      "totalPages": 8
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.