USCDI v3.1 Coverage

The Patient Chart exposes United States Core Data for Interoperability (USCDI) v3.1 data classes through its APIs. This release expands the API and data layer with new medical history record types, additional clinical data classes, new endpoints, and expanded demographic metadata.

Patient Chart APIs return USCDI v3.1 data in FHIR R4 structures consistent with the rest of the Patient Chart surface. Data availability depends on the source documents Health Gorilla ingests and on the Consolidated Clinical Document Architecture (C-CDA) sections and templates from which clinical data is parsed.

The Patient Chart UI surfaces additional medical history imported from source documents under new read-only Medical History pages, and applies demographic and clinical label and layout refinements. What appears on each page depends on the source documents Health Gorilla ingests.

Supported Data Classes

The following USCDI v3.1 data classes are available through the Patient Chart APIs:

Social Determinants of Health (SDOH) classification on Procedures, Diagnoses, and the new Medical History record types: Goals, Health Concerns, Interventions, Indications, and Assessment and Plan planned procedures
Clinical Tests
Laboratory Specimen Details
Health Insurance
Care Team Members
Encounter Disposition

New Medical History Record Types

The Patient Chart APIs support these new medical history record types, each available through its own Patient Chart search endpoint that returns FHIR R4 resource shapes:

Record Type	Description
Goals	Patient health goals expressed in clinical documentation.
Health Concerns	Clinically relevant patient health concerns.
Interventions	Clinical interventions documented as part of care planning or delivery.
Indications	Clinical indications associated with treatments or procedures.

Indications is available through the API. It doesn't currently have a corresponding read-only page in the Patient Chart UI, and it's a separate concept from the Assessments page described under Patient Chart UI Updates.

Demographic Metadata Enhancements

Patient demographic metadata has been expanded to align with USCDI v3.1:

Gender metadata supports expanded value representations for patient identity
Ethnicity metadata supports expanded value representations for patient demographics

Related Person Endpoints

The FHIR R4 RelatedPerson resource returns the individuals associated with a patient, such as family members, caregivers, or guardians:

GET /fhir/R4/RelatedPerson?patient={id}
GET /fhir/R4/RelatedPerson/{id}

Each RelatedPerson carries the related person's name, relationship, phone numbers, and addresses.

Patient Chart UI Updates

The Patient Chart includes these UI updates aligned with USCDI v3.1:

Social Determinants of Health Medical History Pages

Four read-only pages under the Medical History menu present data imported from C-CDA documents:

Goals: the Goals page lists the patient's health goals. Each row shows the effective date, the goal, its value, the provider, and the source. Select a row to open the goal's details, which include the effective date, the started and stopped dates when set, and any priorities.
Health Concerns: the Health Concerns page lists the patient's health concerns and risk concerns. Each row shows the date, the type, the concern, the provider, and the source. Select a row to open the details, which include the effective, started, and stopped dates, the type, the concern, related observations, priorities, and source links when present.
Interventions: the Interventions page lists interventions. Each row shows the date, the type, the provider, and the source. For an intervention imported from a C-CDA document, the Provider column is blank, and the authoring providers appear in the detail view instead. Select a row to open the details, which include the type, the authoring providers, related procedures, and participants.
Assessments: the Assessments page lists the patient's assessments, including SDOH assessments. Each row shows the effective date, the assessment, an SDOH indicator, the provider, and the source. Select a row to open the details, which include the effective date, the assessment, the SDOH indicator, the provider, and the data origin.

Label and Layout Refinements

Demographic and clinical pages carry USCDI v3.1 label and layout refinements:

Demographics labels: Suffix is labeled Name suffix; Deceased date is labeled Date of death; Email is labeled Email address; Current Address is labeled Current address; phone labels are normalized.
Insurance: the Policy number field is labeled Policy ID, and the Group number field is labeled Group ID.
Encounters: the performer and location appear together in a single Performer / Location column, showing the organization name, National Provider Identifier (NPI), phone, address, and fax.
Allergies: the Category column follows the Substance column.
Imaging: the imaging detail shows the test performed at the top, with the radiology result in a collapsible Report section.

Related Person Display

In the Demographics section, under Contact Information, each Related Person shows the name, relationship, phone numbers, and addresses. Patient Summary shows the related person's name and expanded Relationship values.

Known Limitation Related to SDOH Assessments

USCDI v3.1 includes an SDOH Assessments data class as a standalone element. Health Gorilla represents this data in two ways, depending on where it appears in the source document.

Health Gorilla classifies SDOH on Procedures, Diagnoses, and the planned procedures parsed from the Assessment and Plan section of a C-CDA document. A planned procedure whose code falls in the SDOH procedure value set is stored as a structured, SDOH-classified record and appears on the Assessments page with an SDOH indicator.

An SDOH assessment carried only as narrative in the Assessment section of a source document is stored as free text. It appears on the Assessments page without an SDOH indicator and isn't represented as a structured, coded data class.