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);
}
Antwort200
{
  "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.

Parameter

audience_idstring

ID of the audience whose membership to read.

Antwort-Payload

membership
object

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

Untergeordnete Attribute anzeigen
membership.total
integer
erforderlich

Number of members at evaluation time.

membership.data_as_of
string
erforderlich

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

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.