Перейти к документации
API

Список рассылок

Все рассылки этого рабочего пространства, сначала новые, по одной странице, у каждой актуальные `counts`. `audienceId` оставляет те, что ушли этой аудитории, одной или вместе с другими.

GETapi.openemail.uk/broadcasts

Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.

GET /broadcasts

Все рассылки этого рабочего пространства, сначала новые, по одной странице, у каждой актуальные counts. audienceId оставляет те, что ушли этой аудитории, одной или вместе с другими.

Пример

Требует emails:read. limit до 100, по умолчанию 25, а cursor принимает nextCursor предыдущей страницы — id её последней рассылки.

curl
curl "$OE/broadcasts?audienceId=aud_4c1b8e2a7d9f05c36b4e8a71&limit=10" -H "$AUTH"
Ответ
{  "object": "list",  "data": [    {      "object": "broadcast",      "id": "brd_5a8c1e3f7b2d94a06c8e1f3b",      "status": "sending",      "mode": "live",      "source": "api",      "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"],      "from": "Acme <[email protected]>",      "subject": "{{firstName|Hello}}, the September release is out",      "counts": {        "recipients": 412,        "created": 250,        "skipped": 1,        "failedToQueue": 0,        "queued": 38,        "sending": 2,        "sent": 209,        "failed": 1,        "cancelled": 0      },      "lastError": null,      "scheduledAt": null,      "startedAt": "2026-09-23T12:00:02.000Z",      "completedAt": null,      "cancelledAt": null,      "createdAt": "2026-09-23T12:00:00.000Z",      "updatedAt": "2026-09-23T12:00:41.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

Отдельных писем здесь нет. Выведите копии одной рассылки через GET /emails?broadcastId=.

Курсор, который не указывает на рассылку этого рабочего пространства, даёт 400 invalid_cursor. audienceId, который не указывает на аудиторию, даёт пустую страницу.