HL7 v2.8.2 Vocabulary
0.1.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.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.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-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:

Properties

This code system defines the following properties for its concepts

NameCodeURITypeDescription
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:

CodeDisplayDefinitionversionIntroducedmodifiedDeutsch (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