# Get SMS/phone contact-preference consent

Operation ID: `patient.getCommunicationConsent`

Get SMS/phone contact-preference consent

## Public method

`getCommunicationConsent`

Signature: `patient.getCommunicationConsent()`

Return type: `Promise<CommunicationConsentResponse>`

## Authentication

Classification: **AUTHENTICATED**

Schemes: `bearerAuth`

## Prerequisites

None documented.

## HTTP

`GET /patients/communication-consent`

## Path parameters

None.

## Query parameters

None.

## Body parameters

None.

Request model: None.

## Request example

None declared in canonical OpenAPI.

## Success responses

| Status | Shape | Content type | Description |
|---|---|---|---|
| `200` | [`CommunicationConsentResponse`](../models/CommunicationConsentResponse.md) | application/json | The patient's SMS/phone contact-preference consent |

## Success response examples

### 200

```json
{
  "effective_date": "2026-01-01",
  "id": "string",
  "phone_permitted": true,
  "sms_permitted": true
}
```

## Common errors

None declared in canonical OpenAPI.

## Error examples

None declared in canonical OpenAPI.

## NodeJS / TypeScript implementation

```ts
import { HCSDK } from "@healthcloudai/hc-sdk";
```

```ts
const result = await patient.getCommunicationConsent();
```

## cURL

```bash
curl -X GET \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  'https://dev-api-patient.health.cloud/patients/communication-consent'
```

## Notes

None.

## Prepared Test Console scenario

No canonical scenario is currently associated.

## Real response

No approved real integration response is currently published. Unapproved candidates are never rendered as examples.