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

This page is part of the Vital Records Death Reporting FHIR Implementation Guide (v3.0.0-ballot: STU 3 Ballot 1) based on FHIR (HL7® FHIR® Standard) R4. The current version which supersedes this version is 2.2.0. For a full list of available versions, see the Directory of published versions

: Marital Status Vital Records - XML Representation

Draft as of 2024-04-05

Raw xml | Download



<ValueSet xmlns="http://hl7.org/fhir">
  <id value="ValueSet-marital-status-vr"/>
  <text>
    <status value="extensions"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p>This value set includes codes based on the following rules:</p><ul><li>Include these codes as defined in <a href="http://terminology.hl7.org/5.0.0/CodeSystem-v3-MaritalStatus.html"><code>http://terminology.hl7.org/CodeSystem/v3-MaritalStatus</code></a><table class="none"><tr><td style="white-space:nowrap"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td></tr><tr><td><a href="http://terminology.hl7.org/5.0.0/CodeSystem-v3-MaritalStatus.html#v3-MaritalStatus-D">D</a></td><td>Divorced</td><td>Marriage contract has been declared dissolved and inactive</td></tr><tr><td><a href="http://terminology.hl7.org/5.0.0/CodeSystem-v3-MaritalStatus.html#v3-MaritalStatus-L">L</a></td><td>Legally Separated</td><td/></tr><tr><td><a href="http://terminology.hl7.org/5.0.0/CodeSystem-v3-MaritalStatus.html#v3-MaritalStatus-M">M</a></td><td>Married</td><td>A current marriage contract is active</td></tr><tr><td><a href="http://terminology.hl7.org/5.0.0/CodeSystem-v3-MaritalStatus.html#v3-MaritalStatus-S">S</a></td><td>Never Married</td><td>No marriage contract has ever been entered</td></tr><tr><td><a href="http://terminology.hl7.org/5.0.0/CodeSystem-v3-MaritalStatus.html#v3-MaritalStatus-W">W</a></td><td>Widowed</td><td>The spouse has died</td></tr></table></li><li>Include these codes as defined in <a href="http://terminology.hl7.org/5.0.0/CodeSystem-v3-NullFlavor.html"><code>http://terminology.hl7.org/CodeSystem/v3-NullFlavor</code></a><table class="none"><tr><td style="white-space:nowrap"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td></tr><tr><td><a href="http://terminology.hl7.org/5.0.0/CodeSystem-v3-NullFlavor.html#v3-NullFlavor-UNK">UNK</a></td><td>unknown</td><td>**Description:**A proper value is applicable, but not known.<br/><br/>**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:<br/><br/>1.  Those properties themselves directly translate to a semantic of &quot;unknown&quot;. (E.g. a local code sent as a translation that conveys 'unknown')<br/>2.  Those properties further qualify the nature of what is unknown. (E.g. specifying a use code of &quot;H&quot; and a URL prefix of &quot;tel:&quot; to convey that it is the home phone number that is unknown.)</td></tr></table></li></ul></div>
  </text>
  <extension
             url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
    <valueCode value="pher"/>
  </extension>
  <url
       value="http://hl7.org/fhir/us/vrdr/ValueSet/ValueSet-marital-status-vr"/>
  <identifier>
    <system value="urn:ietf:rfc:3986"/>
    <value value="urn:oid:2.16.840.1.113883.4.642.40.10.48.3"/>
  </identifier>
  <version value="3.0.0-ballot"/>
  <name value="ValueSetMaritalStatusVitalRecords"/>
  <title value="Marital Status Vital Records"/>
  <status value="draft"/>
  <experimental value="false"/>
  <date value="2024-04-05T15:54:34+00:00"/>
  <publisher value="HL7 International / Public Health"/>
  <contact>
    <name value="HL7 International / Public Health"/>
    <telecom>
      <system value="url"/>
      <value value="http://www.hl7.org/Special/committees/pher"/>
    </telecom>
    <telecom>
      <system value="email"/>
      <value value="pher@lists.HL7.org"/>
    </telecom>
  </contact>
  <description
               value="The set of codes used to indicate the marital status of the decedent
."/>
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="US"/>
    </coding>
  </jurisdiction>
  <compose>
    <include>
      <system value="http://terminology.hl7.org/CodeSystem/v3-MaritalStatus"/>
      <concept>
        <code value="D"/>
        <display value="Divorced"/>
      </concept>
      <concept>
        <code value="L"/>
        <display value="Legally Separated"/>
      </concept>
      <concept>
        <code value="M"/>
        <display value="Married"/>
      </concept>
      <concept>
        <code value="S"/>
        <display value="Never Married"/>
      </concept>
      <concept>
        <code value="W"/>
        <display value="Widowed"/>
      </concept>
    </include>
    <include>
      <system value="http://terminology.hl7.org/CodeSystem/v3-NullFlavor"/>
      <concept>
        <code value="UNK"/>
        <display value="unknown"/>
      </concept>
    </include>
  </compose>
</ValueSet>