Ir a la documentación
API

Listar los contactos de una audiencia

Los contactos en sí, no los registros de membresía, en el mismo orden que la lista de contactos: primero los vistos más recientemente y al final los contactos a los que nunca se ha escrito. `limit` llega hasta 200 y su valor por defecto es 50. Leer aquí la audiencia por defecto devuelve la libreta de direcciones entera.

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

Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.

GET /audiences/{id}/contacts

Los contactos en sí, no los registros de membresía, en el mismo orden que la lista de contactos: primero los vistos más recientemente y al final los contactos a los que nunca se ha escrito. limit llega hasta 200 y su valor por defecto es 50. Leer aquí la audiencia por defecto devuelve la libreta de direcciones entera.

Ejemplo

Requiere audiences:read por sí solo, sin contacts:read.

curl
curl "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts?limit=50" -H "$AUTH"
Respuesta
{  "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"}

Una clave que tenga audiences:read lee las direcciones de una audiencia sin tener contacts:read. Emítela de forma deliberada.

Un contacto que no esté en ninguna audiencia tuya sigue estando en la predeterminada, así que nada de la libreta queda invisible para esta ruta.