List Audience Members

Iterate through the contacts in an audience, with lightweight details for each.

GEThttps://api.audienceful.com/v2/audiences/{id}/members

curl --location --request GET 'https://api.audienceful.com/v2/audiences/jQKdwqp3YRRtTrwqUJEp7d/members' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <your-api-key>'

{
  "data": [
    {
      "id": "jQKdwqp3YRRtTrwqUJEp7d",
      "email": "person@example.com",
      "status": "active",
      "created_at": "2026-07-04T12:00:00Z",
      "last_activity": "2026-07-06T09:12:00Z"
    },
    {
      "id": "o4i4TNZnWsq2f2ZWVqNNWY",
      "email": "another@example.com",
      "status": "active",
      "created_at": "2026-07-05T08:30:00Z",
      "last_activity": null
    }
  ],
  "has_more": true,
  "next_cursor": "cD0yMDI2LTA3LTA0VDEyOjAwOjAwWg"
}

Requires the audiences:read scope. Returns the contacts in an audience, cursor-paginated so you can iterate an audience of any size.

Pass a real audience id, or the reserved id all to page through every active subscriber in the workspace. One-time send audiences are not addressable here, matching List Audiences.

The member shape is intentionally lean — enough to identify each contact without slowing down iteration over a large audience. When you need a contact's full profile (tags, custom fields, engagement rates), fetch it from Retrieve a Contact.

Path parameters

idstringrequired

The audience's id, or all for every active subscriber in the workspace.

Query parameters

page_sizenumberdefault: 100

The number of members to return per page. Maximum 500.

cursorstring

The pagination cursor from a previous response's next_cursor. See Pagination.

Response

dataarray

The page of audience members.

Properties

idstring

The contact's id. Use it with Retrieve a Contact for full detail.

emailstring

The contact's email address.

statusstring

The contact's subscription/deliverability status — one of active, unconfirmed, bounced, unsubscribed, not_subscribed, or cleaned.

created_atstring

The datetime (UTC) the contact was created.

last_activitystring or null

The datetime (UTC) of the contact's last activity.

has_moreboolean

Whether more members exist after this page.

next_cursorstring or null

The cursor to pass as ?cursor= to fetch the next page. null when there are no more pages.