HL7 Terminology (THO)
4.0.0 - Publication International flag

This page is part of the HL7 Terminology (v4.0.0: Release) based on FHIR R4. The current version which supercedes this version is 5.2.0. For a full list of available versions, see the Directory of published versions

: MaritalStatus - XML Representation

Active as of 2019-03-20

Raw xml | Download



<CodeSystem xmlns="http://hl7.org/fhir">
  <id value="v3-MaritalStatus"/>
  <language value="en"/>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><p><b>Properties</b></p><table class="grid"><tr><td><b>Code</b></td><td><b>URL</b></td><td><b>Type</b></td><td><b>Description</b></td></tr><tr><td>Specializes</td><td/><td>Coding</td><td>The child code is a more narrow version of the concept represented by the parent code.  I.e. Every child concept is also a valid parent concept.  Used to allow determination of subsumption.  Must be transitive, irreflexive, antisymmetric.</td></tr><tr><td>Generalizes</td><td/><td>Coding</td><td>Inverse of Specializes.  Only included as a derived relationship.</td></tr><tr><td>internalId</td><td>http://terminology.hl7.org/CodeSystem/utg-concept-properties#v3-internal-id</td><td>code</td><td>The internal identifier for the concept in the HL7 Access database repository.</td></tr><tr><td>status</td><td>http://hl7.org/fhir/concept-properties#status</td><td>code</td><td>Designation of a concept's state. Normally is not populated unless the state is retired.</td></tr></table><p>This code system <code>http://terminology.hl7.org/CodeSystem/v3-MaritalStatus</code> defines the following codes:</p><table class="codes"><tr><td><b>Lvl</b></td><td style="white-space:nowrap"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td><td><b>internalId</b></td><td><b>status</b></td></tr><tr><td>1</td><td style="white-space:nowrap">A<a name="v3-MaritalStatus-A"> </a></td><td>Annulled</td><td>Marriage contract has been declared null and to not have existed</td><td>12213</td><td>active</td></tr><tr><td>1</td><td style="white-space:nowrap">D<a name="v3-MaritalStatus-D"> </a></td><td>Divorced</td><td>Marriage contract has been declared dissolved and inactive</td><td>12214</td><td>active</td></tr><tr><td>1</td><td style="white-space:nowrap">I<a name="v3-MaritalStatus-I"> </a></td><td>Interlocutory</td><td>Subject to an Interlocutory Decree.</td><td>12215</td><td>active</td></tr><tr><td>1</td><td style="white-space:nowrap">L<a name="v3-MaritalStatus-L"> </a></td><td>Legally Separated</td><td/><td>12216</td><td>active</td></tr><tr><td>1</td><td style="white-space:nowrap">M<a name="v3-MaritalStatus-M"> </a></td><td>Married</td><td>A current marriage contract is active</td><td>12217</td><td>active</td></tr><tr><td>2</td><td style="white-space:nowrap">  C<a name="v3-MaritalStatus-C"> </a></td><td>Common Law</td><td>a marriage recognized in some jurisdictions and based on the parties' agreement to consider themselves married and can also be based on documentation of cohabitation.

This definition was based on https://www.merriam-webster.com/dictionary/common-law%20marriage.</td><td>24122</td><td>active</td></tr><tr><td>1</td><td style="white-space:nowrap">P<a name="v3-MaritalStatus-P"> </a></td><td>Polygamous</td><td>More than 1 current spouse</td><td>12220</td><td>active</td></tr><tr><td>1</td><td style="white-space:nowrap">T<a name="v3-MaritalStatus-T"> </a></td><td>Domestic partner</td><td>Person declares that a domestic partner relationship exists.</td><td>15981</td><td>active</td></tr><tr><td>1</td><td style="white-space:nowrap">U<a name="v3-MaritalStatus-U"> </a></td><td>unmarried</td><td>Currently not in a marriage contract.</td><td>23624</td><td>active</td></tr><tr><td>2</td><td style="white-space:nowrap">  S<a name="v3-MaritalStatus-S"> </a></td><td>Never Married</td><td>No marriage contract has ever been entered</td><td>12218</td><td>active</td></tr><tr><td>1</td><td style="white-space:nowrap">W<a name="v3-MaritalStatus-W"> </a></td><td>Widowed</td><td>The spouse has died</td><td>12219</td><td>active</td></tr></table></div>
  </text>
  <url value="http://terminology.hl7.org/CodeSystem/v3-MaritalStatus"/>
  <identifier>
    <system value="urn:ietf:rfc:3986"/>
    <value value="urn:oid:2.16.840.1.113883.5.2"/>
  </identifier>
  <version value="2.1.0"/>
  <name value="MaritalStatus"/>
  <title value="MaritalStatus"/>
  <status value="active"/>
  <date value="2019-03-20"/>
  <publisher value="Health Level 7"/>
  <contact>
    <name value="Health Level Seven"/>
  </contact>
  <description
               value="\* \* \* No description supplied \* \* \*

*Open Issue:* The specific meanings of these codes can vary somewhat by jurisdiction and implementation so caution should be used when determining equivalency.

*Open Issue:* fixing and completion of the hierarchy and proper good definitions of all the concepts is badly needed."/>
  <caseSensitive value="true"/>
  <hierarchyMeaning value="is-a"/>
  <content value="complete"/>
  <property>
    <extension
               url="http://terminology.hl7.org/StructureDefinition/ext-mif-relationship-symmetry">
      <valueCode value="antisymmetric"/>
    </extension>
    <extension
               url="http://terminology.hl7.org/StructureDefinition/ext-mif-relationship-transitivity">
      <valueCode value="transitive"/>
    </extension>
    <extension
               url="http://terminology.hl7.org/StructureDefinition/ext-mif-relationship-reflexivity">
      <valueCode value="irreflexive"/>
    </extension>
    <extension
               url="http://terminology.hl7.org/StructureDefinition/ext-mif-relationship-isNavigable">
      <valueBoolean value="true"/>
    </extension>
    <extension
               url="http://terminology.hl7.org/StructureDefinition/ext-mif-relationship-relationshipKind">
      <valueCode value="Specializes"/>
    </extension>
    <extension
               url="http://terminology.hl7.org/StructureDefinition/ext-mif-relationship-inverseName">
      <valueString value="Generalizes"/>
    </extension>
    <code value="Specializes"/>
    <description
                 value="The child code is a more narrow version of the concept represented by the parent code.  I.e. Every child concept is also a valid parent concept.  Used to allow determination of subsumption.  Must be transitive, irreflexive, antisymmetric."/>
    <type value="Coding"/>
  </property>
  <property>
    <extension
               url="http://terminology.hl7.org/StructureDefinition/ext-mif-relationship-symmetry">
      <valueCode value="antisymmetric"/>
    </extension>
    <extension
               url="http://terminology.hl7.org/StructureDefinition/ext-mif-relationship-transitivity">
      <valueCode value="transitive"/>
    </extension>
    <extension
               url="http://terminology.hl7.org/StructureDefinition/ext-mif-relationship-reflexivity">
      <valueCode value="irreflexive"/>
    </extension>
    <extension
               url="http://terminology.hl7.org/StructureDefinition/ext-mif-relationship-isNavigable">
      <valueBoolean value="true"/>
    </extension>
    <extension
               url="http://terminology.hl7.org/StructureDefinition/ext-mif-relationship-relationshipKind">
      <valueCode value="Generalizes"/>
    </extension>
    <extension
               url="http://terminology.hl7.org/StructureDefinition/ext-mif-relationship-inverseName">
      <valueString value="Specializes"/>
    </extension>
    <code value="Generalizes"/>
    <description
                 value="Inverse of Specializes.  Only included as a derived relationship."/>
    <type value="Coding"/>
  </property>
  <property>
    <code value="internalId"/>
    <uri
         value="http://terminology.hl7.org/CodeSystem/utg-concept-properties#v3-internal-id"/>
    <description
                 value="The internal identifier for the concept in the HL7 Access database repository."/>
    <type value="code"/>
  </property>
  <property>
    <code value="status"/>
    <uri value="http://hl7.org/fhir/concept-properties#status"/>
    <description
                 value="Designation of a concept's state. Normally is not populated unless the state is retired."/>
    <type value="code"/>
  </property>
  <concept>
    <code value="A"/>
    <display value="Annulled"/>
    <definition
                value="Marriage contract has been declared null and to not have existed"/>
    <property>
      <code value="status"/>
      <valueCode value="active"/>
    </property>
    <property>
      <code value="internalId"/>
      <valueCode value="12213"/>
    </property>
  </concept>
  <concept>
    <code value="D"/>
    <display value="Divorced"/>
    <definition
                value="Marriage contract has been declared dissolved and inactive"/>
    <property>
      <code value="status"/>
      <valueCode value="active"/>
    </property>
    <property>
      <code value="internalId"/>
      <valueCode value="12214"/>
    </property>
  </concept>
  <concept>
    <code value="I"/>
    <display value="Interlocutory"/>
    <definition value="Subject to an Interlocutory Decree."/>
    <property>
      <code value="status"/>
      <valueCode value="active"/>
    </property>
    <property>
      <code value="internalId"/>
      <valueCode value="12215"/>
    </property>
  </concept>
  <concept>
    <code value="L"/>
    <display value="Legally Separated"/>
    <property>
      <code value="status"/>
      <valueCode value="active"/>
    </property>
    <property>
      <code value="internalId"/>
      <valueCode value="12216"/>
    </property>
  </concept>
  <concept>
    <code value="M"/>
    <display value="Married"/>
    <definition value="A current marriage contract is active"/>
    <property>
      <code value="status"/>
      <valueCode value="active"/>
    </property>
    <property>
      <code value="internalId"/>
      <valueCode value="12217"/>
    </property>
    <concept>
      <code value="C"/>
      <display value="Common Law"/>
      <definition
                  value="a marriage recognized in some jurisdictions and based on the parties' agreement to consider themselves married and can also be based on documentation of cohabitation.

This definition was based on https://www.merriam-webster.com/dictionary/common-law%20marriage."/>
      <property>
        <code value="status"/>
        <valueCode value="active"/>
      </property>
      <property>
        <code value="internalId"/>
        <valueCode value="24122"/>
      </property>
    </concept>
  </concept>
  <concept>
    <code value="P"/>
    <display value="Polygamous"/>
    <definition value="More than 1 current spouse"/>
    <property>
      <code value="status"/>
      <valueCode value="active"/>
    </property>
    <property>
      <code value="internalId"/>
      <valueCode value="12220"/>
    </property>
  </concept>
  <concept>
    <code value="T"/>
    <display value="Domestic partner"/>
    <definition
                value="Person declares that a domestic partner relationship exists."/>
    <property>
      <code value="status"/>
      <valueCode value="active"/>
    </property>
    <property>
      <code value="internalId"/>
      <valueCode value="15981"/>
    </property>
  </concept>
  <concept>
    <code value="U"/>
    <display value="unmarried"/>
    <definition value="Currently not in a marriage contract."/>
    <property>
      <code value="status"/>
      <valueCode value="active"/>
    </property>
    <property>
      <code value="internalId"/>
      <valueCode value="23624"/>
    </property>
    <concept>
      <code value="S"/>
      <display value="Never Married"/>
      <definition value="No marriage contract has ever been entered"/>
      <property>
        <code value="status"/>
        <valueCode value="active"/>
      </property>
      <property>
        <code value="internalId"/>
        <valueCode value="12218"/>
      </property>
    </concept>
  </concept>
  <concept>
    <code value="W"/>
    <display value="Widowed"/>
    <definition value="The spouse has died"/>
    <property>
      <code value="status"/>
      <valueCode value="active"/>
    </property>
    <property>
      <code value="internalId"/>
      <valueCode value="12219"/>
    </property>
  </concept>
</CodeSystem>