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

Список контактов аудитории

Сами контакты, а не записи о членстве, в том же порядке, что и список контактов: сначала те, кого видели последними, а контакты, которым никогда не писали, — в конце. `limit` доходит до 200, по умолчанию 50. Чтение аудитории по умолчанию здесь возвращает всю адресную книгу.

GETapi.openemail.uk/audiences/{id}/contacts

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

GET /audiences/{id}/contacts

Сами контакты, а не записи о членстве, в том же порядке, что и список контактов: сначала те, кого видели последними, а контакты, которым никогда не писали, — в конце. limit доходит до 200, по умолчанию 50. Чтение аудитории по умолчанию здесь возвращает всю адресную книгу.

Пример

Требуется только audiences:read, без contacts:read.

curl
curl "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts?limit=50" -H "$AUTH"
Ответ
{  "object": "list",  "data": [    {      "object": "contact",      "email": "[email protected]",      "name": "Grace Hopper",      "source": "manual",      "notes": null,      "lastSeenAt": null,      "createdAt": "2026-09-18T09:00:00.000Z",      "updatedAt": "2026-09-18T09:00:00.000Z"    }  ],  "hasMore": false,  "nextCursor": null,  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71"}

Ключ с audiences:read читает адреса в аудитории, не имея contacts:read. Выдавайте его осознанно.

Контакт, не входящий ни в одну из ваших аудиторий, всё равно состоит в аудитории по умолчанию, поэтому для этого маршрута в книге нет ничего невидимого.