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 Examples

This table provides a correlation between USCDI+ behavioral health data elements and their corresponding FHIR elements, illustrating how each data element is represented in the BH FHIR implementation guide. It includes specific examples and narratives for each matched representation, demonstrating how they are applied in practical scenarios, such as documenting allergies, health assessments, clinical notes, and patient demographics. This ensures that healthcare data is accurately represented and easily interoperable across different health information systems.

USCDI+ BH
Data Class
USCDI+ BH
Data Element
FHIR Example FHIR Narrative
Adverse Event Adverse Event fall-adverse-event-example Example of patient adverse fall event
Allergies and Intolerances Reaction peanut-allergy-example
penicillin-allergy-example
Examples of allergic response to peanuts and penicillin
Allergies and Intolerances Substance (Medication) penicillin-allergy-example Example of patient documented penicillin allergy
Allergies and Intolerances Substance (Non-Medication) peanut-allergy-example Example of patient documented peanut allergy
Care Team Member(s) Care Team Member Role care-team-example Example of a mental health counselor as part of the care team
Care Team Member(s) Care Team Member Telecom physician-example
pcp-provider-example
mental-health-provider-example
Examples of a patient's emergency room provider, Primary care provider and mental health provider telecom
Care Team Member(s) Care Team Member Identifier physician-example
pcp-provider-example
mental-health-provider-example
Examples of a patient's emergency room provider, Primary care provider and mental health provider identifiers
Clinical Notes Mental Health Consultation Note mental-health-consult-note-example Example of a mental health consult note. Clinical details of note content are encoded (base64)
Clinical Notes Mental Health Discharge Summary Note mental-health-discharge-note-example Example of a mental health discharge summary note. Clinical details of note content are encoded (base64)
Clinical Notes Mental Health History & Physical mental-health-history-physical-note-example Example of a mental health history and physical note. Clinical details of note content are encoded (base64)
Clinical Notes Mental Health Procedure Note mental-health-procedure-note-example Example of a mental health procedure note. Clinical details of note content are encoded (base64)
Clinical Notes Mental Health Progress Note mental-health-progress-note-example Example of a mental health progress note. Clinical details of note content are encoded (base64)
Clinical Tests Clinical Test hemoglobin-a1c-example Example of laboratory test - Hemoglobin A1C
Clinical Tests Clinical Test Result/Report hemoglobin-a1c-example Example of laboratory test result - elevated value
Consent Consent consent-disclosure-example Example of a consent for information disclosure. Information is encoded (base64)
Diagnostic Imaging Diagnostic Imaging Report ekg-impression-report-example Example of EKG impression report
Diagnostic Imaging Diagnostic Imaging Test ekg-impression-report-example Example of EKG test report
Encounter Information Diagnosis Rank discharge-encounter-example Example of the ranking of diagnosis in the discharge encounter 
Encounter Information Encounter Diagnosis discharge-encounter-example Example of encounter diagnosis
Encounter Information Encounter Disposition discharge-encounter-example Example of encounter disposition
Encounter Information Encounter Location discharge-encounter-example Example of encounter location
Encounter Information Encounter Time discharge-encounter-example Example of encounter time
Encounter Information Encounter Type discharge-encounter-example Example of encounter type such as observation or ambulatory
Facility Information Facility Type obs-location-example
ed-location-example
Examples of facility locations
Family Health History Family Health History mental-health-physical-note-example Example of clinical note that contains family health history. Clinical details of note content are encoded (base64)
Federal/State Grants Reporting Requirements Grant Number bh-grant-info-obs-example Example of a grant with a unique identifier 
Federal/State Grants Reporting Requirements Grant Program ID bh-grant-info-obs-example Example of a grant program ID
Federal/State Grants Reporting Requirements Grant/Funding Type bh-grant-info-obs-example Example of an identified grant funding type 
Goals and Preferences Care Experience Preference provider-preference-obs-example Example of a care experience preference for female providers
Goals and Preferences Patient Goals sdoh-referral-example Example of a patient goal to improve toward adequate social participation
Goals and Preferences SDOH Goals food-insecurity-example
housing-insecurity-example
transportation-insecurity-example
Examples of food, housing, and transportation SDOH goals
Goals and Preferences Treatment Intervention Preference no-morphine-preference-obs-example Example of a treatment intervention preference to avoid morphine based on past history of substance abuse
Health Insurance Information Plan Name medicaid-coverage-example Example of health insurance coverage name
Health Insurance Information Coverage Status medicaid-coverage-example Example of health insurance coverage status
Health Insurance Information Coverage Type medicaid-coverage-example Example of health insurance coverage type
Health Insurance Information Group Identifier medicaid-coverage-example Example of health insurance group identifier
Health Insurance Information Member Identifier medicaid-coverage-example Example of health insurance member identifier
Health Insurance Information Payer Identifier medicaid-coverage-example Example of health insurance payer identifier
Health Insurance Information Relationship to Subscriber medicaid-coverage-example Example of health insurance relationship to subscriber
Health Insurance Information Subscriber Identifier medicaid-coverage-example Example of health insurance subscriber ID
Health Status Assessments Depression Assessment Patient Health Questionnaire-9 (PHQ-9) Example of a depression assessment/screening
Health Status Assessments Mental/Cognitive Status Mini-Mental State Examination [MMSE] Example of a mental/cognitive health status assessment/screening
Health Status Assessments Anxiety Assessment anxiety-assessment-obs-example Example of an anxiety assessment/screening
Health Status Assessments Alcohol Use Alcohol Use Disorder Identification Test - Consumption [AUDIT-C] Example of patient alcohol use status assessment/screening
Health Status Assessments Disability Status Comprehensive Universal Behavior Health Screen (CUBS)© Example of disability status health status assessment/screening
Health Status Assessments Food Insecurity prapare-questionnaireresponse-example Example of SDOH food assessment/screening
Health Status Assessments Functional Status barthel-index-example Example of functional health status assessment/screening
Health Status Assessments Housing Instability prapare-questionnaireresponse-example Example of SDOH housing assessment/screening
Health Status Assessments Pregnancy Status pregnancy-example Example of patient pregnancy status assessment/screening
Health Status Assessments SDOH Assessment prapare-questionnaireresponse-example Example of SDOH health status assessment
Health Status Assessments Smoking Status non-smoker-example Example of patient smoking status assessment/screening
Health Status Assessments Substance Use substance-use-condition-example Example of substance use health status assessment
Health Status Assessments Transportation Insecurity prapare-questionnaireresponse-example Example of SDOH transportation assessment/screening
Health Status Assessments Suicide Risk Assessment Columbia-Suicide Severity Rating Scale (C-SSRS) Example of suicide risk assessment/screening
Health Status Assessments Interpersonal Violence Humiliation, Afraid, Rape, and Kick questionnaire (HARK) Example of Interpersonal Violence assessment/screening
Health Status Assessments Mental Health Status Screen Mini-Mental State Examination [MMSE] Example of a behavioral health focused mental health status screening
Health Status Assessments Mental Trauma and PTSD Assessment Adverse Childhood Experiences (ACEs) Assessment Example of a mental trauma or PTSD assessment/screening
Immunizations Immunizations flu-vaccine-example Example of patient flu vaccine (immunization)
Laboratory Tests hemoglobin-a1c-example Example of laboratory test - Hemogobin A1C
Laboratory Values/Results hemoglobin-a1c-example Example of laboratory test result - elevated value 
Medications Discharge Medications paroxetine-discharge-example
metformin-discharge-example
ativan-discharge-example
Example of discharge medications to be continued at home
Medications Dose paroxetine-discharge-example Example of medication dose
Medications Dose Unit of Measure paroxetine-discharge-example Example of medication dose unit of measure
Medications Medications benzo-medication-example Example of benzodiazepine medication
Medications Medication Adherence paroxetine-discharge-med-example Example of medication adherence - not taking antidepressant
Medications Medication Instructions paroxetine-discharge-example
benzo-order-example
Example of medication instructions - paroxetine
Medications Medication Quantity paroxetine-discharge-example Example of medication quantity
Medications Medications Dispensed bupropion-dispense-example Example of dispensed medication - bupropion
Patient Demographics Name to Use patient-example Example of patient preferred name
Patient Demographics Current Address patient-example Example of patient address
Patient Demographics Date of Birth patient-example Example of patient date of birth
Patient Demographics Email Address patient-example Example of patient email address
Patient Demographics Ethnicity patient-example Example of patient ethnicity
Patient Demographics First Name patient-example Example of patient first name
Patient Demographics Gender Identity patient-example Example of patient gender identify
Patient Demographics Last Name patient-example Example of patient last name
Patient Demographics Name Suffix patient-example Example of patient name suffix
Patient Demographics Phone Number patient-example Example of patient phone number
Patient Demographics Preferred Language patient-example Example of patient preferred language
Patient Demographics Race patient-example Example of patient race
Patient Demographics Related Person's Name adult-child-relatedperson-example Example of patient related person's name
Patient Demographics Relationship Type adult-child-relatedperson-example Example of patient related person's relationship
Patient Demographics Sex patient-example Example of patient sex 
Patient Demographics Sexual Orientation sexual-orientation-example Example of patient sexual orientation
Patient Demographics Tribal Affiliation patient-example Example of patient tribal affiliation
Patient Demographics Date of Death patient-example Example of patient date of death
Patient Demographics Identifier patient-example Example of patient patient identifier
Patient Demographics   Pronouns patient-example Example of patient preferred pronouns
Patient Summary and Plan Assessment and Plan of Treatment mental-health-progress-note-example Example of assessment and plan of treatment recorded within a note. Clinical details of note content are encoded (base64)
Problems Problems/Conditions panic-attack-example
chest-pain-example
grief-example
substance-abuse-condition-example
diabetes-example
Examples of diagnosis
Problems SDOH Problems/Health Concerns substance-abuse-condition-example Example of patient history of substance abuse
Problems Date of Diagnosis panic-attack-example
chest-pain-example
grief-example
substance-abuse-condition-example
diabetes-example
Example of diagnosis date
Problems Date of Onset panic-attack-example
chest-pain-example
grief-example
substance-abuse-condition-example
diabetes-example
Example of diagnosis onset date
Problems Date of Resolution panic-attack-example
chest-pain-example
grief-example
substance-abuse-condition-example
diabetes-example
Example of diagnosis resolution date
Procedures Harm Reduction Activities harm-reduction-activities-example Example of patient harm reduction program
Procedures Performance Time alcohol-prevention-edu-example Example of a documented time when alcohol harm reduction information was provided
Procedures Procedures alcohol-prevention-edu-example Example of patient alcohol harm reduction education
Procedures Reason for Referral sdoh-referral-example Example of patient referral to a peer coaching program
Procedures SDOH Interventions sdoh-referral-example Example of social connection intervention
Procedures Peer Coaching or Mentoring sdoh-referral-example Example of a referral for peer support or mentoring
Procedures Recovery Planning alcohol-prevetion-edu-example Example of recovery planning services
Vital Signs Body Height height-example Example of body height
Vital Signs Body Temperature temperature-example Example of body temperature
Vital Signs Body Weight weight-example Example of body weight
Vital Signs Diastolic Blood Pressure blood-pressure-example Example of diastolic blood pressure
Vital Signs Heart Rate heart-rate-example Example of heart rate
Vital Signs Pulse Oximetry oxygen-saturation-example Example of pulse oximetry 
Vital Signs Respiratory Rate respiratory-rate-example Example of respiratory rate
Vital Signs Systolic Blood Pressure blood-pressure-example Example of systolic blood pressure
Vital Signs Average Blood Pressure average-bp-example Example of average blood pressure
Work Information Farmworker Status history-of-occupation-example Example of patient usual occupation as a citrus farm worker
Work Information Veteran Status patient-example Example of patient with a veteran status equals true