List an audience's contacts
The contacts themselves rather than membership records, in the same order as the contacts list: most recently seen first, with contacts that have never been mailed last. `limit` goes up to 200 and defaults to 50. Reading the default audience here returns the whole address book.
Runs the real call against your workspace, with your own key.
GET /audiences/{id}/contacts
The contacts themselves rather than membership records, in the same order as the contacts list: most recently seen first, with contacts that have never been mailed last. limit goes up to 200 and defaults to 50. Reading the default audience here returns the whole address book.
Example
Needs audiences:read alone, without contacts:read.
curl "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts?limit=50" -H "$AUTH"{ "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"}A key holding audiences:read reads the addresses in an audience without holding contacts:read. Issue it deliberately.
A contact in no audience of your own is still in the default one, so nothing in the book is invisible to this route.