---
title: "Get Marketing Preferences by Contact Id"
method: GET
path: "/contacts/{contactId}/preferences"
tags: ["Contacts"]
---

# Get Marketing Preferences by Contact Id

`GET /contacts/{contactId}/preferences`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/contacts/{contactId}/preferences`
- Auth: `appAuth` (a scheme the document does not define)

See glossary for definition of <a href="https://developers.zoopla.co.uk/docs/glossary#person">Person</a> and <a href="https://developers.zoopla.co.uk/docs/glossary#contact">Contact</a>.

## Path parameters

- `contactId` string, required

## Headers

- `AgencyRef` string, required

## Response `200`

Contact Consent Preferences returned for ContactId.

- AltoInternalDomainModelsContactsContactConsentPreference[]
  - `id` integer
  - `recordId` integer
  - `groupId` integer
  - `versionNumber` integer
  - `contactId` integer
  - `dateActioned` string, date-time, nullable
  - `optInStatus` 'Denied' | 'Granted' | 'Unknown' | 'GrantedOrUnknown'
  - `type` 'PropertyMatching' | 'GeneralMarketing' | 'FinancialServices' | 'ConveyancingServices' | 'MoveIt' | 'RelocationAgentNetwork' | 'KeyfloViewingNotifications'
  - `actionedBy` string, nullable
  - `additionalInformation` string, nullable

## Other responses

- `400`: Validation error e.g. invalid ContactId.
- `404`: Not Found

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)