HL7 v2.8.2 Vocabulary
0.2.0 - ci-build

HL7 v2.8.2 Vocabulary, published by HL7/FO. This guide is not an authorized publication; it is the continuous build for version 0.2.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.v282/ and changes regularly. See the Directory of published versions

## CodeSystem: Marital Status (2.8.2 - 1.1.0) (Experimental)

Official URL: http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus | Version: 1.1.0
Active as of 2026-03-13 | Computable Name: MaritalStatus
Other Identifiers: OID:2.16.840.1.113883.18.179, urn:ietf:rfc:3986#Uniform Resource Identifier (URI)#http://terminology.hl7.org/v2plusvocab/CodeSystem/v2-0002
Copyright/Legal: HL7 Inc., 2026

Code system of concepts specifying a person's marital (civil/legal) status. Used in HL7 Version 2.x messages in the PID segment.

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

- Hl7VSmaritalStatus

Properties

This code system defines the following properties for its concepts

Name | Code | URI | Type | Description
version introduced | versionIntroduced | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionIntroduced | string | version when was this code introduced
version deprecated | versionDeprecated | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionDeprecated | string | version when was this code deprecated
status | status | http://hl7.org/fhir/concept-properties#status | code | A code that indicates the status of the concept. Typical values are active, experimental, deprecated, and retired
comment, to suppress IG-publisher warning, to be replaced with standard later | comment | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#comment | string | A string that provides additional detail pertinent to the use or understanding of the concept
usage | usage | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#usage | string | usage notes for this code
modified | modified | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#modified | dateTime | date of last modification
living together | livingTogether | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#livingTogether | boolean | livingTogether
married | married | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#married | boolean | married

Concepts

This case-sensitive code system `http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus` defines the following codes:

Code | Display | Definition | version introduced | modified | Deutsch (German, de)
A | Separated | Separated | 2.1 | 2015-07-13 | getrennt lebend
B | Unmarried | Unmarried | 2.4 | 2015-07-13 | ledig
C | Common law | Common law | 2.4 | 2015-07-13 | eheähnliche Gemeinschaft
D | Divorced | Divorced | 2.1 | 2015-07-13 | geschieden
E | Legally Separated | Legally Separated | 2.4 | 2015-07-13 | rechtskräftig getrennt
G | Living together | Living together | 2.4 | 2015-07-13 | zusammenlebend
I | Interlocutory | Interlocutory | 2.4 | 2015-07-13 |
M | Married | Married | 2.1 | 2015-07-13 | verheiratet
N | Annulled | Annulled | 2.4 | 2015-07-13 | annulliert
O | Other | Other | 2.4 | 2015-07-13 | sonstiges
P | Domestic partner | Domestic partner | 2.4 | 2015-07-13 | häuslicher Partner
R | Registered domestic partner | Registered domestic partner | 2.4 | 2015-07-13 |
S | Single | Single | 2.1 | 2015-07-13 | allein lebend
T | Unreported | Unreported | 2.4 | 2015-07-13 | keine Angabe
U | Unknown | Unknown | 2.4 | 2015-07-13 | unbekannt
W | Widowed | Widowed | 2.1 | 2015-07-13 | verwitwet