US Behavioral Health Profiles Implementation Guide
0.1.0 - CI Build United States of America flag

US Behavioral Health Profiles Implementation Guide, published by . This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/us-behavioral-health-profiles/ and changes regularly. See the Directory of published versions

+BH to FHIR Profile

This table serves as a crosswalk between USCDI+ behavioral health data elements and their corresponding proposed FHIR profiles. The table maps the +BH data classes and elements, such as adverse events, allergies, clinical notes, and patient demographics, to FHIR profiles, showing how each USCDI+ BH element aligns with FHIR's data standards. This alignment facilitates the standardized exchange of health information across different systems, ensuring consistency and interoperability in managing and sharing healthcare data.

USCDI+ BH
Data Class
USCDI+ BH
Data Element
Proposed FHIR Profile Proposed FHIR Data Element
Adverse Event Adverse Event Adverse Event -Base FHIR n/a
Allergies and Intolerances Reaction US Core AllergyIntolerance Profile allergyIntolerance.reaction.manifestation
Allergies and Intolerances Substance (Medication) US Core AllergyIntolerance Profile allergyIntolerance.code
Allergies and Intolerances Substance (Non-Medication) US Core AllergyIntolerance Profile allergyIntolerance.code
Care Team Member(s) Care Team Member Role US Core Care Team Profile careTeam.participant.role
Care Team Member(s) Care Team Member Telecom US Core Care Practitioner Profile practitioner.telecom
Care Team Member(s) Care Team Member Identifier US Core Care Practitioner Profile practitioner.identifier
Clinical Notes Mental Health Consultation Note US Behavioral Health Mental Health Clinical Notes Profile documentReference.type
Clinical Notes Mental Health Discharge Summary Note US Behavioral Health Mental Health Clinical Notes Profile documentReference.type
Clinical Notes Mental Health History & Physical US Behavioral Health Mental Health Clinical Notes Profile documentReference.type
Clinical Notes Mental Health Procedure Note US Behavioral Health Mental Health Clinical Notes Profile documentReference.type
Clinical Notes Mental Health Progress Note US Behavioral Health Mental Health Clinical Notes Profile documentReference.type
Clinical Tests Clinical Test US Core Observation Clinical Result Profile observation.code
Clinical Tests Clinical Test Result/Report US Core Observation Clinical Result Profile observation.value
Consent Consent SDOH Clinical Care Consent Profile n/a
Diagnostic Imaging Diagnostic Imaging Report US Core DiagnosticReport Profile for Report and Note Exchange diagnosticReport.result
Diagnostic Imaging Diagnostic Imaging Test US Core Diagnostic Report diagnosticReport.code
Encounter Information Diagnosis Rank US Core Encounter Profile encounter.diagnosis.rank
Encounter Information Encounter Diagnosis US Core Encounter Profile encounter.diagnosis 
Encounter Information Encounter Disposition US Core Encounter Profile encounter.hospitalization.dischargeDisposition
Encounter Information Encounter Location US Core Encounter Profile encounter.location
Encounter Information Encounter Time US Core Encounter Profile encounter.period
Encounter Information Encounter Type US Core Encounter Profile encounter.type
Facility Information Facility Type US Core Location Profile location.type
Family Health History Family Health History US Behavioral Health Mental Health Clinical Notes Profile n/a
Federal/State Grants Reporting Requirements Grant Number US Behavioral Health Grant Information Observation Profile observation.code
Federal/State Grants Reporting Requirements Grant Program ID US Behavioral Health Grant Information Observation Profile observation.extension
Federal/State Grants Reporting Requirements Grant/Funding Type US Behavioral Health Grant Information Observation Profile observation.category
Goals and Preferences Care Experience Preference US Core Care Experience Preference Profile (STU7) n/a
Goals and Preferences Patient Goals US Core Goal Profile goal.description
Goals and Preferences SDOH Goals US Core Goal Profile goal.description
Goals and Preferences Treatment Intervention Preference US Core Treatment Intervention Preference Profile (STU7) n/a
Health Insurance Information Plan Name US Core Coverage Profile coverage.payor.name
Health Insurance Information Coverage Status US Core Coverage Profile coverage.status
Health Insurance Information Coverage Type US Core Coverage Profile coverage.type
Health Insurance Information Group Identifier US Core Coverage Profile coverage.class:group
Health Insurance Information Member Identifier US Core Coverage Profile coverage.memberID
Health Insurance Information Payer Identifier US Core Coverage Profile coverage.payor.identifier
Health Insurance Information Relationship to Subscriber US Core Coverage Profile coverage.relationship
Health Insurance Information Subscriber Identifier US Core Coverage Profile coverage.subscriberID
Health Status Assessments Depression Assessment US Core QuestionnaireResponse Profile
US Core Observation Screening Assessment Profile
n/a
Health Status Assessments Mental/Cognitive Status US Core Questionnaire Response
US Core Observation Screening Assessment Profile
n/a
Health Status Assessments Anxiety Assessment US Core Questionnaire Response
US Core Observation Screening Assessment Profile
n/a
Health Status Assessments Alcohol Use US Core Questionnaire Response
US Core Observation Screening Assessment Profile
n/a
Health Status Assessments Disability Status US Core Questionnaire Response
US Core Observation Screening Assessment Profile
n/a
Health Status Assessments Food Insecurity US Core Questionnaire Response
US Core Observation Screening Assessment Profile
n/a
Health Status Assessments Functional Status US Core Questionnaire Response
US Core Observation Screening Assessment Profile
n/a
Health Status Assessments Housing Instability US Core Questionnaire Response
US Core Observation Screening Assessment Profile
n/a
Health Status Assessments Pregnancy Status US Core Observation Pregnancy Status Profile observation.value
Health Status Assessments SDOH Assessment US Core Questionnaire Response
US Core Observation Screening Assessment Profile
n/a
Health Status Assessments Smoking Status US Core Smoking Status Observation Profile observation.value
Health Status Assessments Substance Use US Core Questionnaire Response
US Core Observation Screening Assessment Profile
n/a
Health Status Assessments Transportation Insecurity US Core Questionnaire Response
US Core Observation Screening Assessment Profile
n/a
Health Status Assessments Suicide Risk Assessment US Core Questionnaire Response
US Core Observation Screening Assessment Profile
n/a
Health Status Assessments Interpersonal Violence US Core Questionnaire Response
US Core Observation Screening Assessment Profile
n/a
Health Status Assessments Mental Health Status Screen US Core Questionnaire Response
US Core Observation Screening Assessment Profile
n/a
Health Status Assessments Mental Trauma and PTSD Assessment US Core Questionnaire Response
US Core Observation Screening Assessment Profile
n/a
Immunizations Immunizations US Core Immunization Profile immunization.vaccineCode
Laboratory Tests US Core Observation Clinical Result Profile observation.code
Laboratory Values/Results US Core Laboratory Result Observation Profile observation.value
Medications Discharge Medications US Core Medication Request Profile medicationRequest.category:us-core
Medications Dose US Core Medication Request Profile medicationRequest.dose
Medications Dose Unit of Measure US Core Medication Request Profile medicationRequest.dose
Medications Medications US Core Medication Profile medication.code
Medications Medication Adherence US Core Medication Request Profile medicationRequest.medicationAdherence
Medications Medication Instructions US Core Medication Request Profile medicationRequest. dosageInstructions
Medications Medication Quantity US Core Medication Request Profile medicationRequest.dispense Request
Medications Medications Dispensed US Core Medication Dispense Profile medicationDispense.
Patient Demographics Name to Use US Core Patient Profile patient.name.use
Patient Demographics Current Address US Core Patient patient.address
Patient Demographics Date of Birth US Core Patient patient.birthDate
Patient Demographics Email Address US Core Patient patient.telecom
Patient Demographics Ethnicity US Core Patient patient.ethnicity
Patient Demographics First Name US Core Patient patient.name.given
Patient Demographics Gender Identity US Core Patient patient.genderIdentity
Patient Demographics Last Name US Core Patient patient.name.family
Patient Demographics Name Suffix US Core Patient patient.name.suffix
Patient Demographics Phone Number US Core Patient patient.telecom
Patient Demographics Preferred Language US Core Patient patient.communication.language
Patient Demographics Race US Core Patient patient.race
Patient Demographics Related Person's Name US Core RelatedPerson Profile relatedPerson.name
Patient Demographics Relationship Type US Core RelatedPerson Profile relatedPerson.relationship
Patient Demographics Sex US Core Patient patient.sex
Patient Demographics Sexual Orientation US Core Observation Sexual Orientation Profile observation.value
Patient Demographics Tribal Affiliation US Core Patient patient.tribalAffiliation
Patient Demographics Date of Death US Core Patient patient.deceased
Patient Demographics Identifier US Core Patient patient.identifier
Patient Demographics   Pronouns US Core Patient patient.name.use
Patient Summary and Plan Assessment and Plan of Treatment US Core DocumentReference Profile n/a
Problems Problems/Conditions US Core Condition Encounter Diagnosis ProfileUS Core Condition Problems and Health Concerns Profile condition.code
Problems SDOH Problems/Health Concerns US Core Condition Encounter Diagnosis ProfileUS Core Condition Problems and Health Concerns Profile condition.code
Problems Date of Diagnosis US Core Condition Encounter Diagnosis ProfileUS Core Condition Problems and Health Concerns Profile condition.onset
Problems Date of Onset US Core Condition Encounter Diagnosis ProfileUS Core Condition Problems and Health Concerns Profile condition.onset
Problems Date of Resolution US Core Condition Problems and Health Concerns Profile condition.abatement
Procedures Harm Reduction Activities US Core Condition Encounter Diagnosis ProfileUS Core Condition Problems and Health Concerns Profile procedure.code
Procedures Performance Time US Core Procedures Profile procedure.performed
Procedures Procedures US Core Procedures Profile procedure.code
Procedures Reason for Referral US Core Procedures Profile serviceRequest.reasonReference
Procedures SDOH Interventions US Core Service Request Profile serviceRequest.code
Procedures Peer Coaching or Mentoring US Core Service Request Profile serviceRequest.code
Procedures Recovery Planning US Core Procedures Profile procedure.code
Vital Signs Body Height US Core Body Height observation.code
Vital Signs Body Temperature US Core Body Temperature observation.code
Vital Signs Body Weight US Core Body Weight observation.code
Vital Signs Diastolic Blood Pressure US Core Blood Pressure Profile observation.code
Vital Signs Heart Rate US Core Heart Rate observation.code
Vital Signs Pulse Oximetry US Core Pulse Oximetry observation.code
Vital Signs Respiratory Rate US Core Respiratory Rate observation.code
Vital Signs Systolic Blood Pressure US Core Blood Pressure Profile observation.code
Vital Signs Average Blood Pressure US Core Average Blood Pressure (STU7) observation.code
Work Information Farmworker Status US Core Occupation Observation observation.code
Work Information Veteran Status US Core Patient extension