Skip to main content

getPatientDemographics

Returns the demographic information HealthEx has on file for a patient in the context of a project: name, date of birth, gender, contact details, mailing address, and the project-scoped externalId. Patient tokens may only fetch their own record; organization users and API clients must own the project and have an active patient-data-sharing consent from the patient on it.

Path Parameters
projectId string — REQUIRED

HealthEx project (study) id

patientId string — REQUIRED

HealthEx patient id

Responses
200

Patient demographics

Schema — OPTIONAL
patientId string

HealthEx patient id.

firstName object — OPTIONAL

Patient's first name.

lastName object — OPTIONAL

Patient's last name.

dateOfBirth object — OPTIONAL

Date of birth in ISO 8601 (YYYY-MM-DD) format.

gender object — OPTIONAL

Patient's gender. Typical values: male, female, other, unknown.

email object — OPTIONAL

Patient's current primary email address.

phone object — OPTIONAL

Patient's current primary phone number in E.164 format.

externalId object — OPTIONAL

Identifier your organization assigned this patient in this project.

addressLines string[] — OPTIONAL

Ordered list of street address lines (street, unit, building, c/o). Empty when no address is on file.

city object — OPTIONAL

City or locality.

district object — OPTIONAL

Second-level administrative division (e.g. county in the US).

state object — OPTIONAL

First-level administrative division (US state, region, province, etc.).

postalCode object — OPTIONAL

ZIP or postal code.

country object — OPTIONAL

ISO country code.