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

Список подписок

Новостные рассылки и списки рассылки, которые получает почтовый ящик, в том виде, в каком их показывает страница «Подписки».

GET/subscriptions

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

GET /subscriptions

Новостные рассылки и списки рассылки, которые получает почтовый ящик, в том виде, в каком их показывает страница «Подписки».

Пример

Требуется threads:read. Отправитель считается подпиской, когда его почта несёт заголовок List-Unsubscribe, по одной строке на каждый адрес, на который он пишет. status равен active, это значение по умолчанию, или unsubscribed, q ищет по отправителю, а sort бывает recent, most, unread или name.

curl
curl "$OE/subscriptions?sort=most&limit=1" -H "$AUTH"
Ответ
{  "object": "list",  "data": [{    "object": "subscription",    "id": "sub_5d2c8e17",    "senderEmail": "[email protected]",    "senderName": "Figma",    "recipient": "[email protected]",    "status": "active",    "method": "one-click",    "linkUrl": "https://www.figma.com/unsubscribe?u=4f1c",    "unread": 12,    "recent": 4,    "total": 58,    "sinceUnsubscribed": 0,    "lastSeenAt": "2026-10-01T07:02:41.000Z",    "unsubscribedAt": null,    "unsubscribedWith": null,    "future": null  }],  "total": 37,  "counts": { "active": 37, "unsubscribed": 9 },  "hasMore": true}

recent считает почту за последние 30 дней, sinceUnsubscribed почту, которая всё равно пришла после того, как вы отписались, а future называет правило, которое продолжает перемещать новую почту отправителя, если такое правило есть.

limit, 50, если вы не скажете иначе, и не больше 200, и offset листают их по страницам. total считает все подходящие строки, а counts считает, сколько из них активны и сколько отменены.

Ключ или приложение, ограниченные отдельными адресами, показывают только подписки, доставляемые на эти адреса, а address сужает список до одного адреса.

Справочник