Skip to main content
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.interchange.io/api/v2/buyer/advertisers/25/audiences?take=50" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
advertiserIdstring (path)YesAdvertiser ID (numeric string, e.g. 25)
takeinteger (query)NoResults to return. Default 50, max 250
skipinteger (query)NoResults 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 customer.
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