US Behavioral Health Profiles Implementation Guide
0.1.0 - CI Build
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
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 |