Get property list

Deprecated. This page documents the v2 buyer API, which is closed to new API clients and switches off on 1 December 2026. Use V3 instead: see Move a v2 buyer REST integration to V3. The conversion endpoint, Log event, stays open.

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.apostra.com/api/v2/buyer/advertisers/12345/property-lists/42 \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	Type	Required	Notes
`advertiserId`	string	Yes	Path. Owning advertiser
`listId`	string	Yes	Path. 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 account.

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

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Get property list

Request

Parameters

Response

Errors

Property list tasks

Property Lists guide

Update property list

List property lists

​Request

​Parameters

​Response

​Errors

​Related

Property list tasks

Property Lists guide

Update property list

List property lists

Request

Parameters

Response

Errors

Related