---
title: "Export Audiences"
method: POST
path: "/v2/exports/audiences"
---

# Export Audiences

`POST /v2/exports/audiences`

## Request

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

Export of every audience. Follow `pagination.nextCursor` until it is `null` to read the full set.

> **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
  - `types` string[]: Only audiences of these types.
  - `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 50. Values are clamped to [1, 100].

## Response `200`

A page of audiences retrieved successfully.

- object
  - `data` object
    - `audiences` object[], required: The current page of audiences.
      - `id` string, uuid, required: The audience ID.
      - `name` string, required: The audience's name.
      - `type` 'STATIC' | 'DYNAMIC', required: Whether membership is managed by hand or by a filter.
      - `createdAt` string, date-time, required: When the audience was created.
      - `updatedAt` string, date-time, required: When the audience was last updated.
  - `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)