List audiences

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

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

List advertisers List available accounts

⌘I

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

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