R4 Ballot #1 (Mixed Normative/Trial use) Current Build
This page was published as part of FHIR v3.3.0: R4 Ballot #1 : Mixed Normative/Trial use (First Normative ballot). It has been superceded by R4 . For a full list of available versions, see the Directory of published versions .

4.3.1.29 4.4.1.293 Value Set http://hl7.org/fhir/ValueSet/marital-status

Patient Administration Work Group   Maturity Level : 5 N Normative (from v4.1.0) Use Context : Not Intended for Production use Any
Normative Candidate Note: This page is candidate normative content for R4 in the Patient Package . Once normative, it will lose it's Maturity Level, and breaking changes will no longer be made.

This is a value set defined by the FHIR project.

Summary

Defining URL: http://hl7.org/fhir/ValueSet/marital-status
Version: 4.1.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 from the following code systems:

  • Include all codes defined in http://hl7.org/fhir/v3/MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus
  • Include these codes as defined in http://hl7.org/fhir/v3/NullFlavor http://terminology.hl7.org/CodeSystem/v3-NullFlavor
    Code Display
    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:
    Those properties themselves directly translate to a semantic of "unknown". (E.g. a local code sent as a translation that conveys 'unknown') 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 03 Apr 2018 21 Jul 2019


This value set contains 11 concepts

Expansion based on http://hl7.org/fhir/v3/NullFlavor http://terminology.hl7.org/CodeSystem/v3-MaritalStatus version 2018-04-01, http://hl7.org/fhir/v3/MaritalStatus 2018-08-12, http://terminology.hl7.org/CodeSystem/v3-NullFlavor version 2018-04-01 2018-08-12
Code System Display Definition
A http://hl7.org/fhir/v3/MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus Annulled Marriage contract has been declared null and to not have existed
D http://hl7.org/fhir/v3/MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus Divorced Marriage contract has been declared dissolved and inactive
I http://hl7.org/fhir/v3/MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus Interlocutory Subject to an Interlocutory Decree.
L http://hl7.org/fhir/v3/MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus Legally Separated Legally Separated
M http://hl7.org/fhir/v3/MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus Married A current marriage contract is active
P http://hl7.org/fhir/v3/MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus Polygamous More than 1 current spouse
S http://hl7.org/fhir/v3/MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus Never Married No marriage contract has ever been entered
T http://hl7.org/fhir/v3/MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus Domestic partner Person declares that a domestic partner relationship exists.
U http://hl7.org/fhir/v3/MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus unmarried Currently not in a marriage contract.
W http://hl7.org/fhir/v3/MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus Widowed The spouse has died
UNK http://hl7.org/fhir/v3/NullFlavor 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: Those properties themselves directly translate to a semantic of "unknown". (E.g. a local code sent as a translation that conveys 'unknown') 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