Vital Records Death Reporting (VRDR) FHIR Implementation Guide
3.0.0 - STU3 United States of America flag

This page is part of the Vital Records Death Reporting FHIR Implementation Guide (v3.0.0: STU3) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Mortality Roster Data Dictionary

The following table illustrates the mappings of fields in the Interjurisdictional Exchange (IJE) formats for mortality to profiles and fields within this FHIR Implementation guide. This information is provided to guide implementers who are transitioning from the familiar IJE to the new FHIR format for this information.

Note that string fields in FHIR-formatted data will often be subject to the same string length limitations of the IJE format for the same content. For example, name fields in IJE (e.g., DINSTI, GNAME) are restricted to 50 characters. Including strings longer than the IJE strength length limitations may lead to data truncation and/or business rule violations when data is sent to certain receivers, including NCHS. The IG includes maximum length restrictions on FHIR strings for some fields, and the FHIR validator will flag violations of these conformance restrictions. The IG does not impose maximum length restrictions for general FHIR fields like names and addresses since this seemed an unnatural constraint of widely used FHIR resources.

Mortality Roster IJE Mapping

# Description IJE Name* Profile Field Type Value Set/Comments
8Date of Death--MonthDOD_MODeathDatevaluedateTimeSee PartialDatesAndTimes
9Date of Death--DayDOD_DYDeathDatevaluedateTimeSee PartialDatesAndTimes
10Date of Death--YearDOD_YRDeathDatevaluedateTimeRequired for processing
6State, U.S. Territory or Canadian Province of Death - literalSTATETEXT_DDeathLocationaddress.state (expanded from 2 letter code)string-
7State, U.S. Territory or Canadian Province of Death - codeDSTATEDeathLocationaddress.state or address.state.extension[nationalReportingJurisdictionId]codeableValueSetStatesTerritoriesAndProvincesVitalRecords or ValueSetJurisdictionVitalRecords
30Death Country - CodeDCOUNTRYCDeathLocationaddress.countrystringValueSetResidenceCountryVitalRecords. Note: For US Death certificates should be US.
1State, U.S. Territory or Canadian Province of Birth - literalSTATEBTHDecedentextension[patient-birthPlace].value[x].state or extension[patient-birthPlace].value[x].state.extension[nationalReportingJurisdictionId] if present (expanded from 2 letter code)stringSee StateLiterals
2State, U.S. Territory or Canadian Province of Birth - codeBPLACE_STDecedentextension[patient-birthPlace].value[x].state or extension[patient-birthPlace].value[x].state.extension[nationalReportingJurisdictionId] if presentstringValueSetJurisdictionVitalRecords
3Decedent's Legal Name--GivenGNAMEDecedentname.given , name.use = officialstringSee Note on Decedent Name
4Decedent's Legal Name--MiddleMIDNAMEDecedentname.given , name.use = official (first letter)stringSee Note on Decedent Name
5Decedent's Legal Name--LastLNAMEDecedentname.family , name.use = officialstringSee Note on Decedent Name
11Date of Birth--MonthDOB_MODecedentbirthDate.valuedateTimeSee PartialDatesAndTimes
12Date of Birth--DayDOB_DYDecedentbirthDate.valuedateTimeSee PartialDatesAndTimes
13Date of Birth--YearDOB_YRDecedentbirthDate.valuedateTimeSee PartialDatesAndTimes
14SexSEXDecedentextension[NVSS-SexAtDeath]codeableAdministrativeGenderVS
NAGender*NO IJE MAPPING*DecedentgendercodeableAdministrativeGenderVS - See Note on Gender
22Decedent's SuffixSUFFDecedentname.suffix , name.use = officialstring-
26Decedent's Maiden NameDMAIDENDecedentname.text , name.use = maidenstring
27State, U.S. Territory or Canadian Province of Decedent's Residence - literalSTATETEXT_RDecedentaddress.state (expanded from 2 letter code)stringSee StateLiterals
28State, U.S. Territory or Canadian Province of Decedent's Residence - codeSTATECDecedentaddress.statestringValueSetStatesTerritoriesAndProvincesVitalRecords
29Birthplace Country - CodeBPLACE_CTDecedentextension[patient-birthPlace].value[x].countrystringValueSetBirthplaceCountryVitalRecords.
31Decedent's Residence Country - CodeCOUNTRYCDecedentaddress.countrystringValueSetResidenceCountryVitalRecords
32Decedent's SSN (may be used by some jurisdictions when allowed by law, to match with the SSN contained with the birth record)SSNDecedentidentifier.value where system = 'http://hl7.org/fhir/sid/us-ssn and type.coding.code="SS"stringtype.coding.code="SB" is deprecated but also supported for compatibility
16Father's First NameDADFNAMEDecedentFathername.given , name.use = officialstring-
17Father's Middle NameDADMIDNAMEDecedentFathername.given , name.use = officialstring-
18Father's SurnameDADLNAMEDecedentFathername.familystring-
23Father's SuffixDADSUFFDecedentFathername.suffix , name.use = officialstring-
19Mother's Given NameMOMGNAMEDecedentMothername.given , name.use = officialstring-
20Mother's Middle NameMOMMIDNAMEDecedentMothername.given , name.use = officialstring-
21Mother's Maiden SurnameMOMMAIDNAMEDecedentMothername.family , name.use = maidenstring-
24Mother's SuffixMOMSUFFDecedentMothername.suffix , name.use = officialstring-

Not Implemented Content

# Description IJE Name* Value Set/Comments
25FillerBLANK1
35Blank for Future ExpansionBLANK2