List audiences

Deprecated. This page documents the v2 buyer API, which is closed to new API clients and switches off on 1 December 2026. Use V3 instead: see Move a v2 buyer REST integration to V3. The conversion endpoint, Log event, stays open.

GET /api/v2/buyer/advertisers/{advertiserId}/audiences Lists stored audience metadata for an advertiser. Each row is a summary — match status, uploaded count, and matched count — for audiences synced via Sync audiences.

Request

curl

curl "https://api.apostra.com/api/v2/buyer/advertisers/25/audiences?take=50" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	Type	Required	Notes
`advertiserId`	string (path)	Yes	Advertiser ID (numeric string, e.g. `25`)
`take`	integer (query)	No	Results to return. Default `50`, max `250`
`skip`	integer (query)	No	Results to skip for pagination. Default `0`

Response

{
  "audiences": [
    {
      "audienceId": "loyalty-members-2026",
      "name": "Loyalty members",
      "accountId": "25",
      "status": "READY",
      "deleted": false,
      "uploadedCount": 48210,
      "matchedCount": 41003,
      "createdAt": "2026-06-01T09:00:00Z",
      "updatedAt": "2026-06-06T09:00:00Z"
    }
  ],
  "total": 1
}

status is PROCESSING, ERROR, READY, or TOO_SMALL. uploadedCount and matchedCount are null until processing completes. Pagination metadata (take, skip, hasMore) is in meta.pagination — see Pagination.

Errors

404 NOT_FOUND — advertiserId does not exist or is not visible to the authenticated account.

See Errors for the full error contract.

Advertiser tasks

All advertiser operations

Advertiser overview

Fields, lifecycle, and concepts

Sync audiences

Add or update audience members

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Request

Parameters

Response

Errors

Advertiser tasks

Advertiser overview

Sync audiences

​Request

​Parameters

​Response

​Errors

​Related

Advertiser tasks

Advertiser overview

Sync audiences

Request

Parameters

Response

Errors

Related