This page is part of the FHIR Specification (v4.3.0: R4B - STU). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2
Patient Administration Work Group | Maturity Level: N | Normative (from v4.0.0) | Use Context: Any |
This page has been approved as part of an ANSI standard. See the Patient Package for further details. |
This is a value set defined by the FHIR project.
Summary
Defining URL: | http://hl7.org/fhir/ValueSet/marital-status |
Version: | 4.3.0 |
Name: | Marital Status Codes |
Title: | MaritalStatus |
Definition: | This value set defines the set of codes that can be used to indicate the marital status of a person. |
Committee: | Patient Administration Work Group |
OID: | 2.16.840.1.113883.4.642.3.29 (for OID based terminology systems) |
Source Resource | XML / JSON |
This value set is used in the following places:
This value set includes codes based on the following rules:
http://terminology.hl7.org/CodeSystem/v3-MaritalStatus
http://terminology.hl7.org/CodeSystem/v3-NullFlavor
Code | Display | Definition |
UNK | unknown | **Description:**A proper value is applicable, but not known. **Usage Notes**: This means the actual value is not known. If the only thing that is unknown is how to properly express the value in the necessary constraints (value set, datatype, etc.), then the OTH or UNC flavor should be used. No properties should be included for a datatype with this property unless: 1. Those properties themselves directly translate to a semantic of "unknown". (E.g. a local code sent as a translation that conveys 'unknown') 2. Those properties further qualify the nature of what is unknown. (E.g. specifying a use code of "H" and a URL prefix of "tel:" to convey that it is the home phone number that is unknown.) |
This expansion generated 28 May 2022
This value set contains 12 concepts
Expansion based on:
Code | System | Display | Definition |
A | http://terminology.hl7.org/CodeSystem/v3-MaritalStatus | Annulled | Marriage contract has been declared null and to not have existed |
D | http://terminology.hl7.org/CodeSystem/v3-MaritalStatus | Divorced | Marriage contract has been declared dissolved and inactive |
I | http://terminology.hl7.org/CodeSystem/v3-MaritalStatus | Interlocutory | Subject to an Interlocutory Decree. |
L | http://terminology.hl7.org/CodeSystem/v3-MaritalStatus | Legally Separated | |
M | http://terminology.hl7.org/CodeSystem/v3-MaritalStatus | Married | A current marriage contract is active |
C | http://terminology.hl7.org/CodeSystem/v3-MaritalStatus | Common Law | a marriage recognized in some jurisdictions and based on the parties' agreement to consider themselves married and can also be based on documentation of cohabitation. This definition was based on https://www.merriam-webster.com/dictionary/common-law%20marriage. |
P | http://terminology.hl7.org/CodeSystem/v3-MaritalStatus | Polygamous | More than 1 current spouse |
T | http://terminology.hl7.org/CodeSystem/v3-MaritalStatus | Domestic partner | Person declares that a domestic partner relationship exists. |
U | http://terminology.hl7.org/CodeSystem/v3-MaritalStatus | unmarried | Currently not in a marriage contract. |
S | http://terminology.hl7.org/CodeSystem/v3-MaritalStatus | Never Married | No marriage contract has ever been entered |
W | http://terminology.hl7.org/CodeSystem/v3-MaritalStatus | Widowed | The spouse has died |
UNK | http://terminology.hl7.org/CodeSystem/v3-NullFlavor | unknown | **Description:**A proper value is applicable, but not known. **Usage Notes**: This means the actual value is not known. If the only thing that is unknown is how to properly express the value in the necessary constraints (value set, datatype, etc.), then the OTH or UNC flavor should be used. No properties should be included for a datatype with this property unless: 1. Those properties themselves directly translate to a semantic of "unknown". (E.g. a local code sent as a translation that conveys 'unknown') 2. Those properties further qualify the nature of what is unknown. (E.g. specifying a use code of "H" and a URL prefix of "tel:" to convey that it is the home phone number that is unknown.) |
See the full registry of value sets defined as part of FHIR.
Explanation of the columns that may appear on this page:
Lvl | A few code lists that FHIR defines are hierarchical - each code is assigned a level. For value sets, levels are mostly used to organize codes for user convenience, but may follow code system hierarchy - see Code System for further information |
Source | 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). If the code is in italics, this indicates that the code is not selectable ('Abstract') |
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 |