Skip to main content
GET /api/v2/buyer/advertisers/{advertiserId}/property-lists/{listId} Returns one property list with its full resolved identifier set and filters. The stored list contains only resolved identifiers — resolutionSummary and the transient unresolvedIdentifiers / registeredIdentifiers from create/update are omitted here.

​
Request

curl https://api.interchange.io/api/v2/buyer/advertisers/12345/property-lists/42 \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
advertiserIdstringYesPath. Owning advertiser
listIdstringYesPath. The property list to fetch

​
Response

{
  "propertyList": {
    "listId": "42",
    "name": "Q1 Campaign - UK Premium",
    "purpose": "include",
    "identifiers": [
      { "type": "domain", "value": "example-times.com" },
      { "type": "domain", "value": "example-press.co.uk" }
    ],
    "domains": ["example-times.com", "example-press.co.uk"],
    "propertyCount": 25,
    "filters": { "channels_any": ["display", "olv"] },
    "createdAt": "2026-01-15T10:30:00.000Z",
    "updatedAt": "2026-01-20T14:45:00.000Z"
  }
}
identifiers is the persisted resolved set. domains is a convenience view of identifiers where type: "domain"; app identifiers are not in it.

​
Errors

  • 404 NOT_FOUND — listId or 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

Update property list

Replace identifiers on this list

List property lists

All lists for an advertiser