Skip to the documentation
API

Retrieve an audience

The same shape as a list row, with a fresh `contactCount`. This is the cheap way to watch a count move without pulling the contacts behind it.

GETapi.openemail.uk/audiences/{id}

Runs the real call against your workspace, with your own key.

GET /audiences/{id}

The same shape as a list row, with a fresh contactCount. This is the cheap way to watch a count move without pulling the contacts behind it.

Example

Needs audiences:read.

curl
curl "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71" -H "$AUTH"
Response
{  "object": "audience",  "id": "aud_4c1b8e2a7d9f05c36b4e8a71",  "name": "Product updates",  "description": "Customers who asked to hear about releases",  "builtin": null,  "contactCount": 3,  "createdAt": "2026-09-18T09:10:00.000Z",  "updatedAt": "2026-09-18T09:10:00.000Z"}

An id from another workspace is a 404 rather than a 403. The API never tells you that something exists somewhere you cannot see.

The default audience reads here like any other, and builtin is default on it.