Skip to main content
GET
/
advertisers
/
{advertiserId}
/
property-lists
List property lists
curl --request GET \
  --url https://api.interchange.io/api/v2/buyer/advertisers/{advertiserId}/property-lists \
  --header 'Authorization: Bearer <token>'
{
  "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
}

Authorizations

​
Authorization
string
header
required

API key or access token

Path Parameters

​
advertiserId
string
required

Unique identifier for the advertiser

Minimum string length: 1
Example:

"12345"

Query Parameters

​
take
integer
default:50

Number of results to return (max 250)

Required range: x <= 250
Example:

50

​
skip
integer
default:0

Number of results to skip for pagination

Required range: 0 <= x <= 9007199254740991
Example:

0

​
purpose
enum<string>

Whether properties in this list should be included or excluded

Available options:
include,
exclude
Example:

"include"

Response

List property lists

Response containing a paginated list of property-list summaries

​
propertyLists
object[]
required

Property lists projected to the summary shape. Use get_property_list for the full resource (domains, filters).

​
total
integer
required

Total count of property lists matching the query

Required range: 0 <= x <= 9007199254740991
Example:

3