Basics

For customers interested in the structured dataset underpinning our product suite (Care Summary, Risk Adjustment, and Quality Gap Closure), Connective Health offers a FHIR data product. The dataset is deduplicated, normalized, and curated using best-in-class data cleansing. The structure of Connective Health’s FHIR interactions and resources are all based on the FHIR R4 specification. Whenever possible, the resources will also implement the corresponding US Core 6.1.0 profile and will pass validations. The curation approach is not one-size-fits-all — instead, it is targeted and configurable. In cases where recency matters (e.g. encounters), there are time-based limits. In other cases (e.g. chronic diseases, medications), there are clinical rules to filter by relevance. In some cases, the dataset can stretch back more than twenty years — but only if clinically relevant and “clean”. In the event that the source data does not satisfy FHIR or US Core profile validations, we will generally still send it, allowing the customer final control over whether to ingest, correct, or disregard the data.

Interaction Patterns

Push

Customer is able to have a FHIR bundle pushed to them:
  • S3 bucket (currently available)
  • Azure (currently available)
  • Google Cloud Storage (soon to be available)

Pull

Customer is able to request a FHIR bundle on demand (soon to be available).

Bundles

Patient Summary Bundle

Base element is a Bundle resource, individual FHIR resources will eventually also be available. All information has been deduplicated, normalized, augmented, and curated prior to inserting into FHIR format.
ResourceUS Core ProfileDescriptionLimit
PatientUS Core PatientBased on the patient being processed. Includes additional addresses, phone numbers, and email addresses found during network searches.1
AllergyIntoleranceUS Core AllergyIntoleranceBased on Connective Health’s patient summary template, which excludes non-clinically relevant content such as “unclassified” allergies.1000
CarePlanUS Core CarePlanBased on Connective Health’s patient summary template. Includes reference to encounter.1000
EncounterUS Core EncounterBased on Connective Health’s patient summary template, which excludes older and less relevant encounters.1000
ImmunizationUS Core ImmunizationBased on Connective Health’s patient summary template. Excludes immunizations with no date, due to FHIR requirements.1000
Observation (Labs)US Core Diagnositic Report LabIncludes all historical labs, not just what is on Connective Health’s patient summary template.1000
MedicationRequest (Medications)US Core MedicationRequestIncludes all historical medications, not just what is on Connective Health’s patient summary template. Excludes medications with neither a code nor a name code, due to FHIR requirements.1000
DocumentReference (Notes)US Core DocumentReferenceIncludes reference to encounter. Configurable to show all historical notes or just those associated with an encounter on the PDF. If the latter, the notes truncation feature is enabled by default.1000
Condition (Problems)US Core Condition Problems Health ConcernsIncludes all historical problems, not just what is on Connective Health’s patient summary template.1000
ProcedureUS Core ProcedureBased on Connective Health’s patient summary template. Includes reference to encounter.1000
DiagnosticReportUS Core DiagnosticReportBased on Connective Health’s patient summary template. Represents imaging reports such as X-Rays, EKGs, etc. Includes embedded Observation Clinical Results.1000
ObservationUS Core Observation Clinical ResultOnly returned as a contained resource.N/A
ObservationUS Core Vital SignsIncludes all historical values of only the vital signs listed below.5000
ObservationUS Core BMI5000
ObservationUS Core Body Height5000
ObservationUS Core Body Temperature5000
ObservationUS Core Heart Rate5000
ObservationUS Core Pulse Oximetry5000
ObservationUS Core Respiratory Rate5000
PractitionerUS Core PractitionerOnly returned as a contained resource.N/A
Practitioner RoleUS Core PractitionerRoleOnly returned as a contained resource.N/A
LocationUS Core LocationOnly returned as a contained resource.N/A