USCDI v3.1 Coverage
As a capability of the Patient Chart, USCDI v3.1 Coverage describes the USCDI v3.1 data classes available through the Patient Chart 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 CDA sections and templates from which clinical data is parsed.
This release expands API and data coverage. Patient Chart UI surfacing of the newly supported data classes is planned for a later release; UI updates in this release are limited to demographic label changes and Related Person display.
Supported Data Classes
The following USCDI v3.1 data classes are now available through the Patient Chart APIs:
- Social Determinants of Health (SDOH) classification on existing Procedures and Diagnoses
- Clinical Tests
- Laboratory Specimen Details
- Health Insurance
- Care Team Members
- Encounter Disposition
New Medical History Record Types
The Patient Chart APIs now support these new medical history record types, each available through its own FHIR-based search endpoint:
| 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. |
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
New endpoints are available on the Patient endpoint for retrieving Related Person resources. Related Persons represent individuals associated with a patient, such as family members, caregivers, or guardians. The new endpoints return the related person's name and expanded Relationship values.
Patient Chart UI Updates
In addition to the API expansion, the Patient Chart includes targeted UI updates aligned with USCDI v3.1:
- Demographic field labels have been updated for clarity: Suffix → Name suffix; Deceased date → Date of death; Email → Email address; Current Address → Current address; phone labels normalized.
- Related Person display in Patient Summary now shows the related person's name and expanded Relationship values.
These UI updates are visible in the Patient Chart immediately. Surfacing of the newly supported USCDI v3.1 data classes in the Patient Chart UI is planned for a later release.
Known Limitation Related to SDOH Assessments
USCDI v3.1 includes a Social Determinants of Health (SDOH) Assessments data class as a standalone element. Health Gorilla supports SDOH classification on existing Procedures and Diagnoses but does not yet support SDOH Assessments as a structured data class.
SDOH Assessments may be present in source documents as free text only. They are:
- Not classified
- Not structured
- Surfaced only as unclassified text where present in source data
Updated about 19 hours ago