HL7 v2.9 Vocabulary
0.1.0 - ci-build

HL7 v2.9 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.v29/ and changes regularly. See the Directory of published versions

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

Official URL: http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus | Version: 1.1.0
Active as of 2026-01-27 | Computable Name: MaritalStatus
Other Identifiers: OID:2.16.840.1.113883.18.179
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
versionIntroduced | versionIntroduced | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionIntroduced | string | version when was this code introduced
versionDeprecated | 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 | 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
livingTogether | 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 | versionIntroduced | 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