# Get a person profile

Operation ID: `person.getPerson`

Get a Person profile by FHIR resource ID, enriched with photo_binary_id when a photo has been uploaded via person.uploadPhoto. Scoped to the caller's tenant (resolved from the Bearer JWT).

## Public method

`get`

Signature: `person.get(fhirPersonId)`

Return type: `Promise<Person>`

## Authentication

Classification: **AUTHENTICATED**

Schemes: `bearerAuth`

## Prerequisites

None documented.

## HTTP

`GET /persons/{person_id}`

## Path parameters

| Name | Type | Required | Format | Allowed values | Default | Nullable | Description |
|---|---|---:|---|---|---|---:|---|
| `person_id` | `string` | Yes |  |  |  | No |  |

## Query parameters

None.

## Body parameters

None.

Request model: None.

## Request example

None declared in canonical OpenAPI.

## Success responses

| Status | Shape | Content type | Description |
|---|---|---|---|
| `200` | [`GetPersonResponse`](../models/GetPersonResponse.md) | application/json | Person profile |

## Success response examples

### 200

```json
{
  "active": true,
  "address": {
    "city": "Boston",
    "country": "US",
    "is_primary": true,
    "state": "MA",
    "street1": "100 Example Avenue",
    "street2": "Apt 4B",
    "type": "home",
    "zip_code": "02108"
  },
  "attributes": {},
  "birth_date": "1990-01-01",
  "cognito_sub": "00000000-0000-4000-8000-000000000000",
  "email": "person.user@example.com",
  "fhir_id": "person-example-001",
  "first_name": "Alex",
  "gender": "female",
  "last_name": "Smith",
  "linked_patient_ids": [
    "patient-example-001"
  ],
  "linked_practitioner_ids": [
    "practitioner-example-001"
  ],
  "middle_name": "Jordan",
  "notes": null,
  "person_id": "00000000-0000-4000-8000-000000000000",
  "person_type": "caregiver",
  "phone": "+15550100000",
  "photo_binary_id": "photo-example-001",
  "prefix": "Ms.",
  "race": [
    "white"
  ],
  "relationship": "caregiver",
  "suffix": "Jr.",
  "tenant_id": "tenant-example-001"
}
```

## Common errors

| Status | Shape | Content type | Description |
|---|---|---|---|
| `401` | [`person.ErrorResponse`](../models/person.ErrorResponse.md) | application/json | Authorization required — missing or invalid Bearer JWT |
| `404` | [`person.ErrorResponse`](../models/person.ErrorResponse.md) | application/json | No Person resource exists for person_id in the caller's tenant |

## Error examples

### 401 — Missing or invalid access token

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

### 404 — FHIR Person resource does not exist (sanitized example)

```json
{
  "error": "Not Found"
}
```

## NodeJS / TypeScript implementation

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

```ts
const fhirPersonId = "<FHIR_PERSON_ID>";

const result = await person.get(fhirPersonId);
```

## cURL

```bash
curl -X GET \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  'https://dev-api-person.health.cloud/persons/%3CPERSON_ID%3E'
```

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