Ir a la documentación
API

Listar suscripciones

Los boletines y las listas de correo que recibe el buzón, tal como los muestra la página Suscripciones.

GET/subscriptions

Ejecuta la llamada real en tu espacio de trabajo.

GET /subscriptions

Los boletines y las listas de correo que recibe el buzón, tal como los muestra la página Suscripciones.

Ejemplo

Requiere threads:read. Un remitente es una suscripción cuando su correo lleva una cabecera List-Unsubscribe, con una fila por cada dirección a la que escribe. status es active, el valor predeterminado, o unsubscribed, q busca en el remitente, y sort es recent, most, unread o name.

curl
curl "$OE/subscriptions?sort=most&limit=1" -H "$AUTH"
Respuesta
{  "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 cuenta el correo de los últimos 30 días, sinceUnsubscribed el correo que siguió llegando después de que te dieras de baja, y future nombra la regla que sigue moviendo su correo nuevo, cuando la hay.

limit, 50 salvo que indiques lo contrario y como mucho 200, y offset las recorren por páginas. total cuenta todas las filas que coinciden, y counts cuántas están activas y cuántas dadas de baja.

Una clave o una app limitada a ciertas direcciones solo lista las suscripciones que se entregan a ellas, y address lo limita a una dirección.

Referencia