Vital Records Common Library (VRCL) FHIR Implementation Guide
2.0.0 - STU2 United States of America flag

Vital Records Common Library (VRCL) FHIR Implementation Guide, published by HL7 International / Public Health. This guide is not an authorized publication; it is the continuous build for version 2.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/vr-common-library/ and changes regularly. See the Directory of published versions

ValueSet: Value Set - Marital Status Vital Records

Official URL: http://hl7.org/fhir/us/vr-common-library/ValueSet/ValueSet-marital-status-vr Version: 2.0.0
Active as of 2026-06-01 Computable Name: ValueSetMaritalStatusVitalRecords

The set of codes used to indicate the marital status of the decedent

Note: 'Domestic Partnership' is not supported by NCHS and will be mapped to 'U' unknown

Mapping to IJE codes here.

References

This value set is not used here; it may be used elsewhere (e.g. specifications and/or implementations that use this content)

Logical Definition (CLD)

This value set includes codes based on the following rules:

  • Include these codes as defined in http://terminology.hl7.org/CodeSystem/v3-MaritalStatus version 📍2018-08-12
    CodeDisplay
    DDivorced
    LLegally Separated
    MMarried
    SNever Married
    WWidowed
    TDomestic Partner
  • Include these codes as defined in http://terminology.hl7.org/CodeSystem/v3-NullFlavor version 📍2018-08-12
    CodeDisplay
    UNK unknown

 

Expansion

Expansion from tx.fhir.org based on:

  • codesystem v3 Code System MaritalStatus version 2018-08-12
  • codesystem v3 Code System NullFlavor version 2018-08-12

This value set contains 7 concepts

SystemCodeDisplay (en)DefinitionJSONXML
http://terminology.hl7.org/CodeSystem/v3-MaritalStatus  DDivorcedMarriage contract has been declared dissolved and inactive
http://terminology.hl7.org/CodeSystem/v3-MaritalStatus  LLegally SeparatedLegally Separated
http://terminology.hl7.org/CodeSystem/v3-MaritalStatus  MMarriedA current marriage contract is active
http://terminology.hl7.org/CodeSystem/v3-MaritalStatus  SNever MarriedNo marriage contract has ever been entered
http://terminology.hl7.org/CodeSystem/v3-MaritalStatus  WWidowedThe spouse has died
http://terminology.hl7.org/CodeSystem/v3-MaritalStatus  TDomestic partnerPerson declares that a domestic partner relationship exists.
http://terminology.hl7.org/CodeSystem/v3-NullFlavor  UNKunknown

Description:A proper value is applicable, but not known.

                       Usage Notes: This means the actual value is not known.  If the only thing that is unknown is how to properly express the value in the necessary constraints (value set, datatype, etc.), then the OTH or UNC flavor should be used.  No properties should be included for a datatype with this property unless:

                    
                       Those properties themselves directly translate to a semantic of "unknown".  (E.g. a local code sent as a translation that conveys 'unknown')
                       Those properties further qualify the nature of what is unknown.  (E.g. specifying a use code of "H" and a URL prefix of "tel:" to convey that it is the home phone number that is unknown.)

Description of the above table(s).