Sign inGet Started

Get audience membership

GET
/v1/audiences/{audience_id}/membership
const result = await bird.audiences.membership(
  "adn_01krdgeqcxet5s7t44vh8rt9mg",
);
if (result.membership) {
  console.log(result.membership.total, result.membership.data_as_of);
}
Response200
{
  "membership": {
    "total": 1284,
    "data_as_of": "2026-10-12T09:41:07.512843Z"
  }
}

Returns the exact number of audience members at the source evaluation instant, including contacts without email and unsubscribed contacts. Membership is absent when the count is unavailable; an empty audience has total zero. For daily observations, use Get audience membership statistics.

Returns 421 when the workspace's organization is served from a different region from the API host. Retry against that workspace's regional host.

Parameters

audience_idstring

ID of the audience whose membership to read.

Response Payload

membership
object

Exact count of all audience members at the source evaluation instant, including contacts without email and unsubscribed contacts.

Show child attributes
membership.total
integer
required

Number of members at evaluation time.

membership.data_as_of
string
required

Source evaluation instant for the live count. Membership changes committed after the read began appear in a later response.

Continue with the documentation, guides and examples for this topic.