HL7 v2.7 Vocabulary
0.1.0 - ci-build

HL7 v2.7 Vocabulary, published by HL7/FO. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/frankoemig/hl7.v2.terminology.v27/ and changes regularly. See the Directory of published versions

## : Name Type (2.7 - 1.0.0) - XML Representation

Active as of 2026-01-27

Raw xml | Download

    <CodeSystem xmlns="http://hl7.org/fhir">
      <id value="nameType2"/>
      <text>
        <status value="generated"/>
        <div xmlns="http://www.w3.org/1999/xhtml"><ul><li>Include all codes defined in <a href="CodeSystem-nameType2.html"><code>http://terminology.hl7.org/v2plusvocab/CodeSystem/nameType2</code></a></li></ul></div>
      </text>
      <extension
                 url="http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-v2versionCreated">
        <valueString value="2.7"/>
      </extension>
      <extension
                 url="http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-versionHistory">
        <valueString value="generate correct history somehow"/>
      </extension>
      <extension
                 url="http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-tableNo">
        <valueString value="0200"/>
      </extension>
      <url value="http://terminology.hl7.org/v2plusvocab/CodeSystem/nameType2"/>
      <identifier>
        <system value="urn:ietf:rfc:3986"/>
        <value value="urn:oid:2.16.840.1.113883.18.105"/>
      </identifier>
      <version value="1.0.0"/>
      <name value="NameType2"/>
      <title value="Name Type (2.7 - 1.0.0)"/>
      <status value="active"/>
      <experimental value="true"/>
      <date value="2026-01-27T19:34:39+00:00"/>
      <publisher value="HL7/FO"/>
      <contact>
        <name value="HL7/FO"/>
        <telecom>
          <system value="url"/>
          <value value="http://www.hl7.org"/>
        </telecom>
      </contact>
      <description
                   value="HL7-defined code system of concepts for types of names for persons.  Used in HL7 Version 2.x messaging in the XPN, PPN, XCN, PID and MRG segments."/>
      <copyright value="HL7 Inc., 2026"/>
      <caseSensitive value="true"/>
      <compositional value="false"/>
      <content value="complete"/>
      <property>
        <code value="versionIntroduced"/>
        <uri
             value="http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionIntroduced"/>
        <description value="version when was this code introduced"/>
        <type value="string"/>
      </property>
      <property>
        <code value="versionDeprecated"/>
        <uri
             value="http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionDeprecated"/>
        <description value="version when was this code deprecated"/>
        <type value="string"/>
      </property>
      <property>
        <code value="status"/>
        <uri value="http://hl7.org/fhir/concept-properties#status"/>
        <description
                     value="A code that indicates the status of the concept. Typical values are active, experimental, deprecated, and retired"/>
        <type value="code"/>
      </property>
      <property>
        <code value="comment"/>
        <uri
             value="http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#comment"/>
        <description
                     value="A string that provides additional detail pertinent to the use or understanding of the concept"/>
        <type value="string"/>
      </property>
      <property>
        <code value="usage"/>
        <uri
             value="http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#usage"/>
        <description value="usage notes for this code"/>
        <type value="string"/>
      </property>
      <property>
        <code value="modified"/>
        <uri
             value="http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#modified"/>
        <description value="date of last modification"/>
        <type value="dateTime"/>
      </property>
      <concept>
        <code value="A"/>
        <display value="Assigned"/>
        <definition value="Assigned"/>
        <property>
          <code value="usage"/>
          <valueString
                       value="A name assigned to a person. Reasons some organizations assign alternate names may include not knowing the person's name, or to maintain anonymity. Some, but not necessarily all, of the name types that people call &quot;alias&quot; may fit into this category."/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.3"/>
        </property>
      </concept>
      <concept>
        <code value="B"/>
        <display value="Birth name"/>
        <definition value="Birth name"/>
        <designation>
          <language value="de"/>
          <value value="Geburtsname"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString
                       value="A name that a person had shortly after being born. Usually for family names but may be used to mark given names at birth that may have changed later.&lt;p&gt;This is not for temporary names assigned at birth while a newborn is not yet named"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.3.1"/>
        </property>
      </concept>
      <concept>
        <code value="BAD"/>
        <display value="Bad Name"/>
        <definition value="Bad Name"/>
        <designation>
          <language value="de"/>
          <value value="ungültiger Name"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString
                       value="A name that was wrongly used in the past and is now maintained only for the purposes of searching"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.7"/>
        </property>
      </concept>
      <concept>
        <code value="C"/>
        <display value="Adopted Name"/>
        <definition value="Adopted Name"/>
        <designation>
          <language value="de"/>
          <value value="angenommener Name"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString value="A name acquired by adoption"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.3"/>
        </property>
      </concept>
      <concept>
        <code value="D"/>
        <display value="Customary Name"/>
        <definition value="Customary Name"/>
        <property>
          <code value="usage"/>
          <valueString value="Known as/conventional/the one you use"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.3"/>
        </property>
      </concept>
      <concept>
        <code value="I"/>
        <display value="Licensing Name"/>
        <definition value="Licensing Name"/>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.4"/>
        </property>
      </concept>
      <concept>
        <code value="K"/>
        <display value="Business name"/>
        <definition value="Business name"/>
        <designation>
          <language value="de"/>
          <value value="Geschäftsname"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString
                       value="A name used in a Professional or Business context. Also includes writer's pseudonym, artist's name, stage name, street name, etc&lt;p&gt;An example of use is where a person with multiple proper names (i.e. married) uses one of the particular names in a professi"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.6"/>
        </property>
      </concept>
      <concept>
        <code value="L"/>
        <display value="Official Registry Name"/>
        <definition value="Official Registry Name"/>
        <designation>
          <language value="de"/>
          <value value="gesetzlicher Name"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString
                       value="The formal name as registered in an official (government) registry, but which name might not be commonly used. May correspond to legal name&lt;p&gt;For many people, customary name is also their official name"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.3"/>
        </property>
      </concept>
      <concept>
        <code value="M"/>
        <display value="Maiden Name"/>
        <definition value="Maiden Name"/>
        <designation>
          <language value="de"/>
          <value value="Name als ledige Person (Ledigenname)"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString value="A name you had just before you got married"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.3"/>
        </property>
      </concept>
      <concept>
        <code value="MSK"/>
        <display value="Masked"/>
        <definition value="Masked"/>
        <designation>
          <language value="de"/>
          <value value="Name ist maskiert"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString
                       value="There is information on this item available but it has not been provided by the sender due to security, privacy or other reasons. There may be an alternate mechanism for gaining access to this information.&lt;p&gt;Note: using this null flavor does provide infor"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.7"/>
        </property>
      </concept>
      <concept>
        <code value="N"/>
        <display value="Nickname"/>
        <definition value="Nickname"/>
        <designation>
          <language value="de"/>
          <value value="Spitzname"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString value="Nickname /&quot;Call me&quot; Name/Street Name"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.4"/>
        </property>
      </concept>
      <concept>
        <code value="NAV"/>
        <display value="Temporarily Unavailable"/>
        <definition value="Temporarily Unavailable"/>
        <designation>
          <language value="de"/>
          <value value="Name zeitweise nicht verfügbar"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString
                       value="Information is not available at this time but it is expected that it will be available later.&lt;p&gt;Includes John or Jane Doe situations"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.7"/>
        </property>
      </concept>
      <concept>
        <code value="NB"/>
        <display value="Newborn Name"/>
        <definition value="Newborn Name"/>
        <designation>
          <language value="de"/>
          <value value="Name des Neugeborenen"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString
                       value="A name assigned on a temporary basis at birth. i.e. &quot;Baby of Smith&quot;"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.7"/>
        </property>
      </concept>
      <concept>
        <code value="NOUSE"/>
        <display value="No Longer To Be Used"/>
        <definition value="No Longer To Be Used"/>
        <designation>
          <language value="de"/>
          <value value="nicht länger in Benutzung"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString value="Name not to be used anymore for personal reasons"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.7"/>
        </property>
      </concept>
      <concept>
        <code value="O"/>
        <display value="Other"/>
        <definition value="Other"/>
        <designation>
          <language value="de"/>
          <value value="sonstiger Name"/>
        </designation>
        <property>
          <code value="status"/>
          <valueCode value="inactive"/>
        </property>
        <property>
          <code value="modified"/>
          <valueDateTime value="2025-08-02"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.3"/>
        </property>
      </concept>
      <concept>
        <code value="P"/>
        <display value="Name of Partner/Spouse"/>
        <definition value="Name of Partner/Spouse"/>
        <property>
          <code value="usage"/>
          <valueString
                       value="Retained for backward compatibility only as of v2.7."/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.3.1"/>
        </property>
      </concept>
      <concept>
        <code value="R"/>
        <display value="Registered Name"/>
        <definition value="Registered Name"/>
        <designation>
          <language value="de"/>
          <value value="Zuchtname bei Tieren"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString
                       value="(animals only)&lt;p&gt;Retained for backwards compatibility only as of v2.7. Use &quot;L&quot; instead - has same meaning"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.4"/>
        </property>
      </concept>
      <concept>
        <code value="REL"/>
        <display value="Religious"/>
        <definition value="Religious"/>
        <property>
          <code value="usage"/>
          <valueString value="e.g. Sister Mary Francis, Brother John"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.7"/>
        </property>
      </concept>
      <concept>
        <code value="S"/>
        <display value="Pseudonym"/>
        <definition value="Pseudonym"/>
        <designation>
          <language value="de"/>
          <value value="Pseudonym (z.B. für Studien)"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString value="Coded Pseudo-Name to ensure anonymity"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.3.1"/>
        </property>
      </concept>
      <concept>
        <code value="T"/>
        <display value="Indigenous/Tribal"/>
        <definition value="Indigenous/Tribal"/>
        <designation>
          <language value="de"/>
          <value value="Stammesname"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString
                       value="Indigenous/Tribal/Community Name  e.g. Chief Red Cloud"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.3.1"/>
        </property>
      </concept>
      <concept>
        <code value="TEMP"/>
        <display value="Temporary Name"/>
        <definition value="Temporary Name"/>
        <designation>
          <language value="de"/>
          <value value="temporärer Name"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString
                       value="A temporary name. Note that a name valid time can provide more detailed information."/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.7"/>
        </property>
      </concept>
      <concept>
        <code value="U"/>
        <display value="Unknown"/>
        <definition value="Unknown"/>
        <designation>
          <language value="de"/>
          <value value="Name unbekannt"/>
        </designation>
        <property>
          <code value="usage"/>
          <valueString value="Unknown"/>
        </property>
        <property>
          <code value="versionIntroduced"/>
          <valueString value="2.3.1"/>
        </property>
      </concept>
    </CodeSystem>