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

ValueSet: Marital Status (2.9 - 1.1.0) (Experimental)

Official URL: http://terminology.hl7.org/v2plusvocab/ValueSet/hl7VSmaritalStatus Version: 1.1.0
Active as of 2026-03-13 Computable Name: Hl7VSmaritalStatus
Other Identifiers: OID:2.16.840.1.113883.21.3, urn:ietf:rfc:3986#Uniform Resource Identifier (URI)#http://terminology.hl7.org/v2plusvocab/ValueSet/v2-0002

Copyright/Legal: HL7 Inc., 2026

Value Set of codes that specify a person's marital (civil/legal) status.

References

This value set is not used here; it may be used elsewhere (e.g. specifications and/or implementations that use this content)

Logical Definition (CLD)

 

Expansion

Expansion performed internally based on codesystem Marital Status (2.9 - 1.1.0) v1.1.0 (CodeSystem)

This value set contains 16 concepts

SystemCodeDisplay (en)DefinitionJSONXML
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  ASeparatedSeparated
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  BUnmarriedUnmarried
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  CCommon lawCommon law
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  DDivorcedDivorced
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  ELegally SeparatedLegally Separated
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  GLiving togetherLiving together
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  IInterlocutoryInterlocutory
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  MMarriedMarried
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  NAnnulledAnnulled
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  OOtherOther
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  PDomestic partnerDomestic partner
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  RRegistered domestic partnerRegistered domestic partner
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  SSingleSingle
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  TUnreportedUnreported
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  UUnknownUnknown
http://terminology.hl7.org/v2plusvocab/CodeSystem/maritalStatus  WWidowedWidowed

Explanation of the columns that may appear on this page:

Level A few code lists that FHIR defines are hierarchical - each code is assigned a level. In this scheme, some codes are under other codes, and imply that the code they are under also applies
System The source of the definition of the code (when the value set draws in codes defined elsewhere)
Code The code (used as the code in the resource instance)
Display The display (used in the display element of a Coding). If there is no display, implementers should not simply display the code, but map the concept into their application
Definition An explanation of the meaning of the concept
Comments Additional notes about how to use the code