---
title: "Export Audience Members"
method: POST
path: "/v2/exports/audience-members"
---

# Export Audience Members

`POST /v2/exports/audience-members`

## Request

- Base URL: `https://pub-api.conversion.ai/api`
- URL: `https://pub-api.conversion.ai/api/v2/exports/audience-members`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`

Export of which contacts are in which audiences right now. Removed members are not returned, so treat each full walk as a snapshot. Follow `pagination.nextCursor` until it is `null`.

> **Request access.** This endpoint is not enabled by default, contact the Conversion team to request access. Calls from accounts without it return `403 export_not_enabled`.

## Request body

- object
  - `audienceIds` string[]: Only these audiences' members. At most 100.
  - `cursor` string: The opaque cursor returned as `pagination.nextCursor` by a previous call. Omit it on the first page. Send it without filters, because the cursor carries them; sending both returns `invalid_filter`.
  - `limit` integer: The maximum number of rows per page. Defaults to 1000. Values are clamped to [1, 5000].

## Response `200`

A page of audience memberships retrieved successfully.

- object
  - `data` object
    - `members` object[], required: The current page of audience memberships.
      - `audienceId` string, uuid, required: The audience.
      - `contactId` string, uuid, required: The contact (joins `contacts.id`).
      - `createdAt` string, date-time, required: When the contact joined the audience.
      - `updatedAt` string, date-time, required: When the membership was last updated.
      - `partitionId` string, uuid: The contact's partition, for members of partitioned audiences. Omitted otherwise.
  - `pagination` object
    - `nextCursor` string, nullable, required: Opaque cursor for the next page, or `null` when there are no more results. A page can be short or empty while the cursor is non-null.

## Other responses

- `400`: The request was malformed or contained invalid data.
- `401`: Authentication failed.
- `403`: The export API is not enabled for this account.
- `500`: An unexpected server error occurred.

---

[API](https://skmtc.dev/conversion/apis/conversion-api.md) - [All operations](https://skmtc.dev/conversion/apis/conversion-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conversion/apis/conversion-api/revisions/8422f815402a?raw)