---
title: "Gets a list of contacts from a given list, subscribed to the specified preference."
method: GET
path: "/v2/address-books/{bookId}/contacts/with-preference/{preferenceId}"
tags: ["ApiPreference"]
---

# Gets a list of contacts from a given list, subscribed to the specified preference.

`GET /v2/address-books/{bookId}/contacts/with-preference/{preferenceId}`

## Request

- Base URL: `https://api.dotdigital.com`
- URL: `https://api.dotdigital.com/v2/address-books/{bookId}/contacts/with-preference/{preferenceId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/dotdigital/apis/apiconnector-com/docs/v2/address-books/:bookId/contacts/with-preference/:preferenceId/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `bookId` integer, required
- `preferenceId` integer, required

## Query parameters

- `minContactId` integer

## Response `200`

- ApiContactIdAndEmail[]
  - `id` integer
  - `email` string, nullable

---

[API](https://skmtc.dev/dotdigital/apis/apiconnector-com.md) - [All operations](https://skmtc.dev/dotdigital/apis/apiconnector-com/llms.txt) - [OpenAPI document](https://skmtc.dev/dotdigital/apis/apiconnector-com/revisions/391b93e8d24a?raw)