Ga direct naar de documentatie
API

De contacten van een audience opvragen

De contacten zelf in plaats van lidmaatschapsrecords, in dezelfde volgorde als de contactenlijst: het laatst geziene eerst, met contacten die nooit zijn gemaild achteraan. `limit` gaat tot 200 en is standaard 50. De standaard-audience hier uitlezen geeft het volledige adresboek terug.

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

Voert de echte aanroep uit op je workspace, met je eigen sleutel.

GET /audiences/{id}/contacts

De contacten zelf in plaats van lidmaatschapsrecords, in dezelfde volgorde als de contactenlijst: het laatst geziene eerst, met contacten die nooit zijn gemaild achteraan. limit gaat tot 200 en is standaard 50. De standaard-audience hier uitlezen geeft het volledige adresboek terug.

Voorbeeld

Vereist alleen audiences:read, zonder contacts:read.

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

Een sleutel met audiences:read leest de adressen in een audience zonder contacts:read te bezitten. Geef zo'n sleutel bewust uit.

Een contact dat in geen enkele eigen audience zit, zit nog steeds in de standaard-audience, dus niets in het adresboek blijft onzichtbaar voor deze route.