---
title: "Get patient contact preferences"
method: GET
path: "/patients/{patientId}/contact-preferences"
tags: ["patients"]
---

# Get patient contact preferences

`GET /patients/{patientId}/contact-preferences`

Returns the valid contacts for a patient as messenger would use them (after doNotContact, enabled channels, template support, etc.)

## Path parameters

- `patientId` string, required

## Query parameters

- `template` string
- `campaignId` string

## Response `200`

Patient contact preferences

- PatientContactPreferencesResponse — This resource represents the set of contact methods Luma Health can currently use to reach a given patient, such as phone numbers and email addresses, along with whether each one is active or archived. It is built from the patient's outbound and external contact records, taking into account do-not-contact status and reasons like the patient being deceased or having asked not to be contacted, so that messaging only targets channels that are currently valid and permitted. It is used by messaging and reminder workflows to decide which contact to use before sending a communication.
  - `validContacts` object[], required — List of valid contacts as messenger would use them
    - `type` string
    - `value` string
    - `active` boolean
    - `archived` boolean

## Other responses

- `401` — Not authenticated
- `403` — Access token does not have the required scope
- `404` — Patient or campaign (when campaignId provided) not found

---

[API](https://skmtc.net/lumahealth/apis/rest-service.md) · [All operations](https://skmtc.net/lumahealth/apis/rest-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lumahealth/rest-service/revisions/d3c75c2a2f1d/schema)