Ves a la documentació
API

Llistar els contactes d'una audiència

Els contactes mateixos en comptes dels registres de pertinença, en el mateix ordre que la llista de contactes: primer els vistos més recentment, i al final els contactes a qui no s'ha escrit mai. `limit` arriba fins a 200 i per defecte és 50. Llegir aquí l'audiència per defecte retorna tota la llibreta d'adreces.

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

Executa la crida real contra el teu espai de treball, amb la teva pròpia clau.

GET /audiences/{id}/contacts

Els contactes mateixos en comptes dels registres de pertinença, en el mateix ordre que la llista de contactes: primer els vistos més recentment, i al final els contactes a qui no s'ha escrit mai. limit arriba fins a 200 i per defecte és 50. Llegir aquí l'audiència per defecte retorna tota la llibreta d'adreces.

Exemple

Requereix només audiences:read, sense contacts:read.

curl
curl "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts?limit=50" -H "$AUTH"
Resposta
{  "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 clau amb audiences:read llegeix les adreces d'una audiència sense tenir contacts:read. Emet-la amb intenció.

Un contacte que no és en cap audiència teva continua sent a la per defecte, de manera que res de la llibreta no és invisible per a aquesta ruta.