US Core 6.1.0 maps each USCDI element to FHIR.
One row per member. The sections below group its columns.
Column Required Format / values Example patient_identifierYes your most stable patient key; must not change for a person or be reused for another MRN-4471903patient_identifier_systemYes URI of the identifier system; a URL you control or an OID http://acme.org/mrnspatient_identifier_typeRecommended MR medical record, MB member number, MC Medicare, MA Medicaid v2-0203 MRpatient_identifier_useRecommended usual, official, temp, secondary identifier-use officialpatient_identifier_assigner_org_npiRecommended 10 digits 1234567893
Column Required Format / values Example identifier_<n>_valueYes the identifier as issued HSX9930012identifier_<n>_systemYes URI of the identifier system; a URL you control or an OID http://acme.org/member-idsidentifier_<n>_typeRecommended v2-0203 codeMBidentifier_<n>_useRecommended usual, official, temp, secondary, old identifier-use officialidentifier_<n>_period_startRecommended date 2024-01-01identifier_<n>_period_endRecommended date 2025-12-31identifier_<n>_assigner_org_npiRecommended 10 digits 1234567893
If you use a slot, fill both value and system. A value without a system is rejected. A slot left blank is ignored.
Number slots from 2 upward, contiguously. Never 2 and 4.
Column Required Format / values Example last_nameYes text Doefirst_nameYes text Janemiddle_nameRecommended text Lname_prefixNo Mr. / Mrs. / Ms. / Dr. Ms.name_suffixRecommended Jr. / Sr. / III previous_nameRecommended family, givenSmith, Jane
Column Required Format / values Example genderYes male, female, other, unknown AdministrativeGender femalesexRecommended 248152002 Female, 248153007 Male US Core Sex 248152002birth_dateRecommended YYYY-MM-DD 1957-03-11deceased_dateIf applicable datetime race_omb_codeRecommended 2106-3 White, 2054-5 Black or African American, 2028-9 Asian, 1002-5 American Indian or Alaska Native, 2076-8 Native Hawaiian or Other Pacific Islander; ;-separated OMB race categories 2106-3race_detailed_codeIf available CDC race code(s), ;-separated detailed race 2108-9ethnicity_omb_codeRecommended 2135-2 Hispanic or Latino, 2186-5 Not Hispanic or Latino OMB ethnicity categories 2186-5ethnicity_detailed_codeIf available CDC ethnicity code(s) detailed ethnicity tribal_affiliation_codeRecommended tribal-entity code TribalEntityUS preferred_languageRecommended BCP 47 simple-language en
Column Required Format / values Example address_line1Recommended text 88 River Rdaddress_line2No text Apt 3cityRecommended text YonkersstateRecommended 2-letter USPS USPS states NYzipRecommended 5 or 9 digits, as a string 10701countyIf available text WestchesterphoneRecommended 10 digits 5551234567phone_typeRecommended home, work, mobile ContactPointUse mobileemailRecommended email address previous_addressRecommended line, city, state, zip12 Elm St, Bronx, NY, 10453previous_address_endIf available date 2024-08-31
Contacts and non-clinician care-team members, such as a daughter, spouse, or guardian. One row per person per patient.
Column Required Format / values Example patient_identifierYes patient key MRN-4471903relationship_codeRecommended DAU daughter, SPS spouse, NCH child v3-RoleCode , v2-0131 DAUlast_nameRecommended text Doefirst_nameRecommended text MaryphoneIf available 10 digits 5559876543preferred_languageIf available BCP 47 simple-language en
Column Required Format / values Example patient_identifierYes patient key MRN-4471903observation_typeYes occupation for the demographics rows; smoking-status, pregnancy-status, pregnancy-intent are Health Status/AssessmentsoccupationstatusYes final, amended, corrected, entered-in-error observation-status finalvalue_codeYes O*NET-SOC occupation code, with value_system Occupation ONETSOC Detail 29-1141.00industry_codeoccupation only NAICS industry code Industry NAICS Detail 622110effective_datetimeRecommended datetime 2026-04-18
These resources are served by Patient Access , Provider Access , and Payer-to-Payer .
