# Name Type (2.7 - 1.0.0) - HL7 v2.7 Vocabulary v0.1.0

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **Name Type (2.7 - 1.0.0)**

## CodeSystem: Name Type (2.7 - 1.0.0) (Experimental) 

| | |
| :--- | :--- |
| *Official URL*:http://terminology.hl7.org/v2plusvocab/CodeSystem/nameType2 | *Version*:1.0.0 |
| Active as of 2026-01-27 | *Computable Name*:NameType2 |
| *Other Identifiers:*OID:2.16.840.1.113883.18.105 | |
| **Copyright/Legal**: HL7 Inc., 2026 | |

 
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. 

 This Code system is referenced in the content logical definition of the following value sets: 

* [Hl7VSnameType](ValueSet-hl7VSnameType.md)



## Resource Content

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

```
