> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List property lists

> List an advertiser's property lists as compact summaries

`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](/v2/buyer/property-lists/tasks/get-property-list) for full content (identifiers, filters).

## Request

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.interchange.io/api/v2/buyer/advertisers/12345/property-lists?purpose=include&take=50 \
    -H "Authorization: Bearer $SCOPE3_API_KEY"
  ```
</CodeGroup>

## Parameters

| Field          | Type    | Required | Notes                                    |
| -------------- | ------- | -------- | ---------------------------------------- |
| `advertiserId` | string  | Yes      | Path. Owning advertiser                  |
| `purpose`      | enum    | No       | Query. Filter to `include` or `exclude`  |
| `take`         | integer | No       | Query. Page size, max 250 (default 50)   |
| `skip`         | integer | No       | Query. Offset for pagination (default 0) |

## Response

```json theme={null}
{
  "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 account.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Property list tasks" href="/v2/buyer/property-lists/tasks" icon="list-check">
    All property list operations
  </Card>

  <Card title="Property Lists guide" href="/v2/guides/property-lists" icon="list">
    Identifier types, resolution, and concepts
  </Card>

  <Card title="Get property list" href="/v2/buyer/property-lists/tasks/get-property-list" icon="magnifying-glass">
    Full resolved resource for one list
  </Card>

  <Card title="Create property list" href="/v2/buyer/property-lists/tasks/create-property-list" icon="plus">
    Create an include or exclude list
  </Card>
</CardGroup>