# Get the authenticated patient

Operation ID: `patient.getPatient`

Return the authenticated patient's full FHIR Patient record — demographics, addresses, phones, insurance, and flags — enriched with `photo_binary_id` and `telehealth_id`. Requires a patient Bearer JWT; the patient is always resolved from the token, never from client input.

## Public method

`getProfile`

Signature: `patient.getProfile()`

Return type: `Promise<PatientResponse>`

## Authentication

Classification: **AUTHENTICATED**

Schemes: `bearerAuth`

## Prerequisites

None documented.

## HTTP

`GET /patients`

## 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` | [`GetPatientResponse`](../models/GetPatientResponse.md) | application/json | The authenticated patient's FHIR Patient record |

## Success response examples

### 200

```json
{
  "active": true,
  "addresses": [],
  "athena_patient_id": "string",
  "athena_practice_id": "string",
  "attributes": {},
  "communications": [
    {
      "language": "string",
      "preferred": false
    }
  ],
  "created_by": "self",
  "created_date": "2026-01-01T09:00:00Z",
  "date_of_birth": "2026-01-01",
  "deceased": false,
  "deceased_cause": "string",
  "deceased_date": "2026-01-01",
  "drivers_license": {
    "expiration_date": "2026-01-01",
    "number": "string",
    "state": "st"
  },
  "email": "user@example.com",
  "emergency_contacts": [],
  "ethnicity": "hispanic_or_latino",
  "fhir_id": "string",
  "flags": {},
  "gender": "male",
  "gender_identity": "man",
  "insurance": [
    {
      "copay": 0,
      "deductible": 0,
      "effective_date": "2026-01-01",
      "group_number": "string",
      "member_id": "string",
      "payer_id": "string",
      "payer_name": "string",
      "plan_name": "string",
      "plan_type": "string",
      "priority": "primary",
      "subscriber_date_of_birth": "2026-01-01",
      "subscriber_first_name": "string",
      "subscriber_id": "string",
      "subscriber_last_name": "string",
      "subscriber_relationship": "self",
      "termination_date": "2026-01-01"
    }
  ],
  "links": [
    {
      "other_patient_fhir_id": "string",
      "type": "seealso"
    }
  ],
  "managing_organization_id": "string",
  "marital_status": "single",
  "mrn": "string",
  "name": {
    "first_name": "string",
    "last_name": "string",
    "middle_name": "string",
    "preferred_name": "string",
    "prefix": "string",
    "suffix": "string",
    "use": "official"
  },
  "nationality": "st",
  "openloop_dietitian_id": "string",
  "openloop_patient_id": "string",
  "patient_id": "00000000-0000-0000-0000-000000000000",
  "phones": [],
  "photo_binary_id": "string",
  "preferred_language": "en",
  "preferred_pharmacy": {
    "address_city": "string",
    "address_state": "string",
    "address_street1": "string",
    "address_street2": "string",
    "address_zip": "string",
    "fax": "string",
    "is_mail_order": false,
    "name": "string",
    "ncpdp_id": "string",
    "notes": "string",
    "npi": "string",
    "pharmacy_id": "string",
    "phone": "string"
  },
  "race": [
    "american_indian_or_alaska_native"
  ],
  "sex_at_birth": "male",
  "steadymd_patient_guid": "string",
  "steadymd_program_guid": "string",
  "telehealth_id": 0
}
```

## Common errors

| Status | Shape | Content type | Description |
|---|---|---|---|
| `401` | [`patient.ErrorResponse`](../models/patient.ErrorResponse.md) | application/json | Authorization required — missing, invalid, expired, or non-patient Bearer JWT |
| `404` | [`patient.ErrorResponse`](../models/patient.ErrorResponse.md) | application/json | The authenticated patient has no FHIR Patient record |

## Error examples

### 401 — Missing or invalid access token

```json
{
  "error": "Authorization required"
}
```

### 404 — Patient not found

```json
{
  "error": "Patient not found"
}
```

## NodeJS / TypeScript implementation

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

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

## cURL

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

## 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.