Skip to main content
GET /api/v2/buyer/advertisers/{advertiserId}/property-lists Returns property lists for an advertiser as compact summaries. Filter by purpose to separate include lists from exclude lists. Fetch a single list with Get property list for full content (identifiers, filters).

​
Request

curl https://api.interchange.io/api/v2/buyer/advertisers/12345/property-lists?purpose=include&take=50 \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
advertiserIdstringYesPath. Owning advertiser
purposeenumNoQuery. Filter to include or exclude
takeintegerNoQuery. Page size, max 250 (default 50)
skipintegerNoQuery. Offset for pagination (default 0)

​
Response

{
  "propertyLists": [
    {
      "listId": "42",
      "name": "Q1 Campaign - UK Premium",
      "purpose": "include",
      "propertyCount": 25,
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedAt": "2026-01-20T14:45:00.000Z"
    }
  ],
  "total": 3
}
Summaries omit identifiers and filters. total is the count matching the query, ignoring pagination.

​
Errors

  • 400 VALIDATION_ERROR — invalid purpose, or take above 250.
  • 404 NOT_FOUND — advertiserId does not exist or is not visible to the authenticated customer.
See Errors for the full error contract.

Property list tasks

All property list operations

Property Lists guide

Identifier types, resolution, and concepts

Get property list

Full resolved resource for one list

Create property list

Create an include or exclude list