US Core Implementation Guide
10.0.0-ballot - STU 10 Ballot United States of America flag

US Core Implementation Guide, published by HL7 International / Cross-Group Projects. This guide is not an authorized publication; it is the continuous build for version 10.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/US-Core/ and changes regularly. See the Directory of published versions

Table of Contents

Page standards status: Informative
0 Table of Contents
1 Home
2 Conformance
2.1 General Requirements
2.2 Must Support
2.2.1 Observation Summary Table
2.3 SMART on FHIR Obligations and Capabilities
2.4 Security
2.5 Requirements Tables
3 Guidance
3.1 USCDI
3.2 General Guidance
3.3 Adverse Events: Clinical Records and Patient Safety Reporting
3.4 Clinical Notes
3.5 Medication List
3.6 Basic Provenance
3.6.1 Using Provenance To Target Resource Elements
3.7 Screening and Assessments
3.8 Relationship With Other IGs
4 Profiles and Extensions
5 Capability Statements and Requirements Resources
6 Search Parameters and Operations
7 Terminology
7.1 VSAC to FHIR Code System Mapping Table
8 Examples
9 Downloads
10 Version History
10.1 Change Log
10.2 Changes Between Versions
11 Looking Ahead
11.1 US Core Roadmap
11.2 Writing Vital Signs
11.3 Writing Clinical Notes
11.4 Patient Data Feed
11.4.1 Patient Data Feed Additional Resources
12 US Core ImplementationGuide Resource
13 Artifacts Summary
13.1 US Core Certifying System Requirements
13.2 US Core Client Requirements
13.3 US Core Server Requirements
13.4 US Core Client CapabilityStatement
13.5 US Core Server CapabilityStatement
13.6 US Core Fetch DocumentReference
13.7 USCoreAllergyintoleranceClinicalStatus
13.8 USCoreAllergyintolerancePatient
13.9 USCoreAppointmentDate
13.10 USCoreAppointmentId
13.11 USCoreAppointmentPatient
13.12 USCoreAppointmentStatus
13.13 USCoreCareplanCategory
13.14 USCoreCareplanDate
13.15 USCoreCareplanPatient
13.16 USCoreCareplanStatus
13.17 USCoreCareteamPatient
13.18 USCoreCareTeamRole
13.19 USCoreCareteamStatus
13.20 USCoreConditionAbatementDate
13.21 USCoreConditionAssertedDate
13.22 USCoreConditionCategory
13.23 USCoreConditionClinicalStatus
13.24 USCoreConditionCode
13.25 USCoreConditionEncounter
13.26 USCoreConditionLastUpdated
13.27 USCoreConditionOnsetDate
13.28 USCoreConditionPatient
13.29 USCoreConditionRecordedDate
13.30 USCoreCoveragePatient
13.31 USCoreDevicePatient
13.32 USCoreDevicerequestAuthoredOn
13.33 USCoreDevicerequestCode
13.34 USCoreDevicerequestId
13.35 USCoreDevicerequestPatient
13.36 USCoreDevicerequestStatus
13.37 USCoreDeviceStatus
13.38 USCoreDeviceType
13.39 USCoreDiagnosticreportCategory
13.40 USCoreDiagnosticreportCode
13.41 USCoreDiagnosticreportDate
13.42 USCoreDiagnosticreportIdentifier
13.43 USCoreDiagnosticreportLastUpdated
13.44 USCoreDiagnosticreportPatient
13.45 USCoreDiagnosticreportStatus
13.46 USCoreDocumentreferenceCategory
13.47 USCoreDocumentreferenceDate
13.48 USCoreDocumentreferenceId
13.49 USCoreDocumentreferencePatient
13.50 USCoreDocumentreferencePeriod
13.51 USCoreDocumentreferenceStatus
13.52 USCoreDocumentreferenceType
13.53 USCoreEncounterClass
13.54 USCoreEncounterDate
13.55 USCoreEncounterDischargeDisposition
13.56 USCoreEncounterId
13.57 USCoreEncounterIdentifier
13.58 USCoreEncounterLastUpdated
13.59 USCoreEncounterLocation
13.60 USCoreEncounterPatient
13.61 USCoreEncounterStatus
13.62 USCoreEncounterType
13.63 USCoreEthnicity
13.64 USCoreFamilymemberhistoryCode
13.65 USCoreFamilymemberhistoryPatient
13.66 USCoreGoalDescription
13.67 USCoreGoalLifecycleStatus
13.68 USCoreGoalPatient
13.69 USCoreGoalTargetDate
13.70 USCoreImagingstudyId
13.71 USCoreImagingstudyIdentifier
13.72 USCoreImagingstudyPatient
13.73 USCoreImmunizationDate
13.74 USCoreImmunizationPatient
13.75 USCoreImmunizationStatus
13.76 USCoreLocationAddress
13.77 USCoreLocationAddressCity
13.78 USCoreLocationAddressPostalcode
13.79 USCoreLocationAddressState
13.80 USCoreLocationName
13.81 USCoreMedicationadministrationEffectiveTime
13.82 USCoreMedicationadministrationId
13.83 USCoreMedicationadministrationPatient
13.84 USCoreMedicationadministrationStatus
13.85 USCoreMedicationdispensePatient
13.86 USCoreMedicationdispenseStatus
13.87 USCoreMedicationdispenseType
13.88 USCoreMedicationrequestAuthoredon
13.89 USCoreMedicationrequestEncounter
13.90 USCoreMedicationrequestIntent
13.91 USCoreMedicationrequestPatient
13.92 USCoreMedicationrequestStatus
13.93 USCoreNutritionorderDatetime
13.94 USCoreNutritionorderId
13.95 USCoreNutritionorderOraldiet
13.96 USCoreNutritionorderPatient
13.97 USCoreNutritionorderStatus
13.98 USCoreObservationCategory
13.99 USCoreObservationCode
13.100 USCoreObservationDate
13.101 USCoreObservationLastUpdated
13.102 USCoreObservationPatient
13.103 USCoreObservationStatus
13.104 USCoreOrganizationAddress
13.105 USCoreOrganizationName
13.106 USCorePatientBirthdate
13.107 USCorePatientDeathDate
13.108 USCorePatientFamily
13.109 USCorePatientGiven
13.110 USCorePatientId
13.111 USCorePatientIdentifier
13.112 USCorePatientName
13.113 USCorePractitionerId
13.114 USCorePractitionerIdentifier
13.115 USCorePractitionerName
13.116 USCorePractitionerrolePractitioner
13.117 USCorePractitionerroleSpecialty
13.118 USCoreProcedureCode
13.119 USCoreProcedureDate
13.120 USCoreProcedurePatient
13.121 USCoreProcedureStatus
13.122 USCoreQuestionnaireresponseAuthored
13.123 USCoreQuestionnaireresponseId
13.124 USCoreQuestionnaireresponsePatient
13.125 USCoreQuestionnaireresponseQuestionnaire
13.126 USCoreQuestionnaireresponseStatus
13.127 USCoreRace
13.128 USCoreRelatedpersonId
13.129 USCoreRelatedpersonName
13.130 USCoreRelatedpersonPatient
13.131 USCoreServicerequestAuthored
13.132 USCoreServicerequestCategory
13.133 USCoreServicerequestCode
13.134 USCoreServicerequestId
13.135 USCoreServicerequestIdentifier
13.136 USCoreServicerequestPatient
13.137 USCoreServicerequestStatus
13.138 USCoreSpecimenId
13.139 USCoreSpecimenPatient
13.140 US Core ADI DocumentReference Profile
13.141 US Core AllergyIntolerance Profile
13.142 US Core Appointment Profile
13.143 US Core Average Blood Pressure Profile
13.144 US Core Blood Pressure Profile
13.145 US Core BMI Profile
13.146 US Core Body Height Profile
13.147 US Core Body Temperature Profile
13.148 US Core Body Weight Profile
13.149 US Core Care Experience Preference Profile
13.150 US Core CarePlan Profile
13.151 US Core CareTeam Profile
13.152 US Core Condition Encounter Diagnosis Profile
13.153 US Core Condition Problems and Health Concerns Profile
13.154 US Core Coverage Profile
13.155 US Core Device Profile
13.156 US Core DeviceRequest Profile
13.157 US Core DiagnosticReport Profile for Laboratory Results Reporting
13.158 US Core DiagnosticReport Profile for Report and Note Exchange
13.159 US Core DocumentReference Profile
13.160 US Core Encounter Profile
13.161 US Core FamilyMemberHistory Profile
13.162 US Core Goal Profile
13.163 US Core Head Circumference Profile
13.164 US Core Heart Rate Profile
13.165 US Core ImagingStudy Profile
13.166 US Core Immunization Profile
13.167 US Core Laboratory Result Observation Profile
13.168 US Core Location Profile
13.169 US Core Medication Profile
13.170 US Core MedicationAdministration Profile
13.171 US Core MedicationDispense Profile
13.172 US Core MedicationRequest Profile
13.173 US Core NutritionOrder Profile
13.174 US Core Observation ADI Documentation Profile
13.175 US Core Observation Clinical Result Profile
13.176 US Core Observation Occupation Profile
13.177 US Core Observation Pregnancy Intent Profile
13.178 US Core Observation Pregnancy Status Profile
13.179 US Core Observation Screening Assessment Profile
13.180 US Core Observation Sexual Orientation Profile
13.181 US Core Organization Profile
13.182 US Core Patient Accommodation Profile
13.183 US Core Patient Profile
13.184 US Core Pediatric BMI for Age Observation Profile
13.185 US Core Pediatric Head Occipital Frontal Circumference Percentile Profile
13.186 US Core Pediatric Weight for Height Observation Profile
13.187 US Core Practitioner Profile
13.188 US Core PractitionerRole Profile
13.189 US Core Procedure Profile
13.190 US Core Provenance Profile
13.191 US Core Pulse Oximetry Profile
13.192 US Core QuestionnaireResponse Profile
13.193 US Core RelatedPerson Profile
13.194 US Core Respiratory Rate Profile
13.195 US Core ServiceRequest Profile
13.196 US Core Simple Observation Profile
13.197 US Core Specimen Profile
13.198 US Core Tobacco And Nicotine Use Observation Profile
13.199 US Core Treatment Intervention Preference Profile
13.200 US Core Vital Signs Profile
13.201 US Core Authentication Time Extension
13.202 US Core Birth Sex Extension
13.203 US Core Direct email Extension
13.204 US Core Ethnicity Extension
13.205 US Core Extension Questionnaire URI
13.206 US Core FamilyMemberHistory Recorder Extension
13.207 US Core Gender Identity Extension
13.208 US Core Individual Sex Extension
13.209 US Core Interpreter Needed Extension
13.210 US Core Jurisdiction Extension
13.211 US Core Medication Adherence Extension
13.212 US Core Race Extension
13.213 US Core Sex Extension
13.214 US Core Tribal Affiliation Extension
13.215 US Core USCDI Requirement Extension
13.216 US Core Clinical Note Type
13.217 US Core Clinical Result Observation Category
13.218 US Core Condition Codes
13.219 US Core Diagnostic Report Category Codes
13.220 US Core DocumentReference Category
13.221 US Core DocumentReference Type
13.222 US Core Goal Codes
13.223 US Core Laboratory Test Codes
13.224 US Core Location Type Codes
13.225 US Core Narrative Status
13.226 US Core Non Laboratory Codes
13.227 US Core Nutrition Assessment
13.228 US Core Practitioner Role Specialty Codes
13.229 US Core Problem or Health Concern
13.230 US Core Procedure Codes
13.231 US Core Screening Assessment Condition Category
13.232 US Core Screening Assessment Observation Category
13.233 US Core Screening Assessment Observation Maximum Category
13.234 US Core ServiceRequest Category Codes
13.235 US Core Simple Observation Category
13.236 US Core Specimen Condition
13.237 US Core Tobacco And Nicotine Observation Status
13.238 US Core CarePlan Category Extension Codes
13.239 US Core Category
13.240 US Core Condition Category Extension Codes
13.241 US Core DocumentReferences Category Codes
13.242 10 minute Apgar Color Example
13.243 10 minute Apgar Heart Rate Example
13.244 10 minute Apgar Muscle Tone Example
13.245 10 minute Apgar Reflex Irritability Example
13.246 10 minute Apgar Respiratory effort Example
13.247 10 Minute Apgar Score Example
13.248 10 Minute Apgar Score Panel Example
13.249 ADI Observation Presence ADI Example
13.250 Ahc-Hrsn Item Observation Example 68517-2
13.251 Alcohol Use Disorder Identification Test - Consumption (AUDIT-C) Questionnaire Example
13.252 Alcohol Use Disorder Identification Test - Consumption (AUDIT-C) QuestionnaireResponse Example
13.253 Alcohol Use Status Example
13.254 Alcoholic Drinks Per Day Example
13.255 AllergyIntolerance Example
13.256 AllergyIntolerance Non-pharmacologic Agent Example
13.257 AllergyIntolerance Provenance Example 1
13.258 AllergyIntolerance Provenance Example 2
13.259 Appointment From Referral Example
13.260 Appointment Resulting In An Encounter Example
13.261 ASL Interpreter Accommodation Example
13.262 At Home In Vitro Test Example
13.263 Audit-C Item Example 68517-2
13.264 Audit-C Item Example 68519-8
13.265 Audit-C Item Example 68520-6
13.266 Audit-C Item Example 75626-2
13.267 Audit-C Panel Example 72109-2
13.268 Average Blood Pressure Example
13.269 Basic Metabolic Panel Example
13.270 Blood Pressure Example
13.271 BMI Example
13.272 Booked Future Appointment Example
13.273 BP Data Absent Example
13.274 Cancelled Appointment Example
13.275 Capillary refill Time Nail Bed Example
13.276 Care Experience Preference Example
13.277 CarePlan Ulcer Example
13.278 CareTeam Example
13.279 CBC Example
13.280 Chest Xray Example
13.281 Cigarette Pack-Years Example
13.282 Clinician Authored Discharge Summary Example
13.283 Colonoscopy Example
13.284 Condition Duodenal Resolved Ulcer Example
13.285 Condition Duodenal Ulcer Example
13.286 Coverage Example
13.287 Deceased Patient Example
13.288 Defibrillator Device Example
13.289 Device Infusion Pump Example
13.290 Device Walker Example
13.291 DeviceRequest CPAP Example
13.292 DeviceRequest Walker Example
13.293 DiagnosticReport Cardiology Report Example
13.294 DiagnosticReport Chest Xray Report Example
13.295 DICOMweb WADO-RS Endpoint Example
13.296 Docref Example 1
13.297 Docref Example 2
13.298 DocumentReference DNR
13.299 DocumentReference Living Will
13.300 DocumentReference POLST (PDF)
13.301 DXA Bone density quantitative measurement panel Example
13.302 DXA Femur-L ArMass BMD Example
13.303 DXA Femur-L T-score BMD Example
13.304 DXA Femur-L Z-score BMD Example
13.305 DXA Hip-L ArMass BMD Example
13.306 DXA Hip-L T-score BMD Example
13.307 DXA Hip-L Z-score BMD Example
13.308 EKG impression Example
13.309 EKG lead Example
13.310 EKG Strip Image
13.311 Electronic Cigarette User Example
13.312 Encounter 1 Example
13.313 Encounter 1036 Example
13.314 Encounter Delivery Example
13.315 Encounter Diagnosis Example 1
13.316 Encounter Diagnosis Example 2
13.317 Encounter From Appointment Example
13.318 Episode Summary Example
13.319 Erythrocytes Example
13.320 Evs Item Example 68516-4
13.321 Evs Item Example 89555-7
13.322 Evs Panel Example 89574-8
13.323 Exercise Per Day Example
13.324 Exercise Per Week Example
13.325 Exercise Vital Sign Questionnaire Example
13.326 Exercise Vital Sign QuestionnaireResponse Example
13.327 FamilyMemberHistory Example
13.328 Goal 1 Example
13.329 Goal 2 Example
13.330 Head Circumference Example
13.331 Health Concern Example
13.332 Healthcare Agent CareTeam Example
13.333 Healthcare Agent CareTeam Example Using the Durable Power of Attorney Role Code
13.334 Healthcare Agent CareTeam Example Using the Healthcare Power of Attorney Role Code
13.335 Heart Rate Example
13.336 Heart rate rhythm Example
13.337 Height Example
13.338 Hematocrit Example
13.339 Hemoglobin Example
13.340 HL7East Example
13.341 Hospital Location
13.342 HVS Item Example 88122-7
13.343 HVS Item Example 88123-5
13.344 HVS Item Example 88124-3
13.345 HVSPanel Example 88121-9
13.346 ImagingStudy Chest Xray Example
13.347 ImagingStudy Multi-series CT Example
13.348 Immunization Example 1
13.349 Immunization Not Done Example
13.350 Jugular vein distension Example
13.351 Length Example
13.352 Leukocytes Example
13.353 Lipemic Serum Specimen Example
13.354 MCH Example
13.355 MCHC Example
13.356 MCV Example
13.357 Medication Dispense Example
13.358 MedicationAdministration Dose Not Given Example
13.359 MedicationAdministration In Progress Vancomycin Example
13.360 MedicationAdministration Inpatient IV Cefazolin Example
13.361 MedicationAdministration PRN Acetaminophen Example
13.362 MedicationRequest Coded Oral Axid Example
13.363 MedicationRequest Contained Oral Axid Example
13.364 MedicationRequest Referenced Oral Axid Example
13.365 MedicationRequest Self Tylenol Example
13.366 Missing Coded Data Example
13.367 MNA-SF Item Example 107108-3
13.368 MNA-SF Item Example 107109-1
13.369 MNA-SF Item Example 107110-9
13.370 MNA-SF Item Example 107111-7
13.371 MNA-SF Item Example 107113-3
13.372 MNA-SF Item Example 107114-1
13.373 MNA-SF Item Example 39156-5
13.374 MNA-SF Panel Example 107107-5
13.375 No ADI Observation Example
13.376 NutritionOrder Cardiac Diet Example
13.377 NutritionOrder Whole Food Diet Example
13.378 Observation SatO2 FiO2 Example
13.379 Occupation Observation Example
13.380 Occupation Observation Example: Industry Unknown
13.381 Occupation Observation Example: Unknown Occupation
13.382 OFC Percentile Example
13.383 Office Visit Follow-up Appointment Example
13.384 Organization 2 Example
13.385 Organization Acme Lab Example
13.386 Organization Acme Payer Example
13.387 Organization Holy Healthcare Example
13.388 Oxygen Saturation Example
13.389 P-R interval {EKG lead} Example
13.390 Patient Child Example
13.391 Patient Example
13.392 Patient Infant Example
13.393 Patient Niece As Durable Power Of Attorney Example
13.394 Patient Niece As Healthcare Power Of Attorney Example
13.395 Patient Niece Example
13.396 Pediatric BMI Example
13.397 Pediatric Wt Example
13.398 PHQ9 Item Example 44250-9
13.399 PHQ9 Item Example 44251-7
13.400 PHQ9 Item Example 44252-5
13.401 PHQ9 Item Example 44253-3
13.402 PHQ9 Item Example 44254-1
13.403 PHQ9 Item Example 44255-8
13.404 PHQ9 Item Example 44258-2
13.405 PHQ9 Item Example 44259-0
13.406 PHQ9 Item Example 44260-8
13.407 PHQ9 Item Example 44261-6
13.408 PHQ9 Item Example 69722-7
13.409 PHQ9 Panel Example 44249-1
13.410 Platelets Example
13.411 Practitioner 1 Example
13.412 Practitioner 2 Example
13.413 Practitioner 3 Example
13.414 Practitioner Pharmacist Example
13.415 PractitionerRole_Practitioner_Endpoint_Bundle_Example Example
13.416 Prapare Item Example 54899-0
13.417 Prapare Item Example 56051-6
13.418 Prapare Item Example 56799-0
13.419 Prapare Item Example 63512-8
13.420 Prapare Item Example 63586-2
13.421 Prapare Item Example 67875-5
13.422 Prapare Item Example 71802-3
13.423 Prapare Item Example 76437-3
13.424 Prapare Item Example 76501-6
13.425 Prapare Item Example 82589-3
13.426 Prapare Item Example 93026-3
13.427 Prapare Item Example 93027-1
13.428 Prapare Item Example 93028-9
13.429 Prapare Item Example 93029-7
13.430 Prapare Item Example 93030-5
13.431 Prapare Item Example 93033-9
13.432 Prapare Item Example 93034-7
13.433 Prapare Item Example 93035-4
13.434 Prapare Item Example 93038-8
13.435 Prapare Multiselect-Item Example 32624-9-Answer0
13.436 Prapare Multiselect-Item Example 32624-9-Answer1
13.437 Prapare Multiselect-Item Example 93031-3-Answer0
13.438 Prapare Multiselect-Item Example 93031-3-Answer1
13.439 Prapare Panel Example 93025-5
13.440 Prapare Panel Example 93039-6
13.441 Prapare Panel Example 93040-4
13.442 Prapare Panel Example 93041-2
13.443 Prapare Panel Example 93042-0
13.444 PRAPARE Panel Example 93043-8
13.445 Pregnancy Intent Observation Example
13.446 Pregnancy Status Observation Example
13.447 Procedure Defibrillator Implant Example
13.448 Procedure Not Done Example
13.449 Prosthetic Knee Example
13.450 Pulse intensity Palpation Example
13.451 Q-T interval {EKG lead} Example
13.452 QRS dur {EKG lead} Example
13.453 Questionnaire Hunger Vital Sign (HVS) Example
13.454 Questionnaire PHQ-9 Example
13.455 Questionnaire PRAPARE Example
13.456 QuestionnaireResponse Glascow Coma Score Example
13.457 QuestionnaireResponse Hunger Vital Sign (HVS) Example
13.458 QuestionnaireResponse PHQ-9 Example
13.459 QuestionnaireResponse PRAPARE Example
13.460 Rehab Example
13.461 Respiratory Rate Example
13.462 Saint Luke W Endpoint Example
13.463 SDOH Problem/Health Concern Example
13.464 Serum BUN Example
13.465 Serum Calcium Example
13.466 Serum Chloride Example
13.467 Serum CO2 Example
13.468 Serum Creatinine Example
13.469 Serum Glucose Example
13.470 Serum Potassium Example
13.471 Serum Sodium Example
13.472 Serum Specimen Example
13.473 ServiceRequest BMP Example
13.474 ServiceRequest CBC Example
13.475 ServiceRequest Chest XRay Example
13.476 ServiceRequest DNR Example
13.477 ServiceRequest EKG Example
13.478 ServiceRequest Food Pantry Referral Example
13.479 ServiceRequest for Rehab Example
13.480 Simple Observation Cognitive Status Example
13.481 Simple Observation Disability Status Example
13.482 Simple Observation Functional Status Example
13.483 Simple Observation Nutrition Status Example
13.484 Simple Observation Nutrition Status MNA-SF Example
13.485 Simple Observation SDOH Example
13.486 Some Day Smoker Example
13.487 Substance Use Status Example
13.488 Taps Item Example 75889-6
13.489 Taps Item Example 88037-7
13.490 Taps Item Example 96842-0
13.491 Taps Item Example 96843-8
13.492 Taps Item Example 96844-6
13.493 Taps Panel Example 96841-2
13.494 Telehealth Appointment Example
13.495 Temperature Example
13.496 Tobacco, Alcohol, Prescription medications, and other Substance use screen (TAPS) Questionnaire Example
13.497 Tobacco, Alcohol, Prescription medications, and other Substance use screen (TAPS) QuestionnaireResponse Example
13.498 Treatment Intervention Preference Example
13.499 Urine Specimen Example
13.500 Urobilinogen Example
13.501 US Core Model Definition
13.502 Uscore Med1 Example
13.503 Uscore Med2 Example
13.504 Weight Example
13.505 Wheelchair Assistance Accommodation Example
13.506 Whole Blood Specimen Example
13.507 Xray Chest Findings Example
13.508 Xray Chest Impression Example
13.509 Expansion Parameters