FHIR Release 3 (STU) CI-Build

This page is part of the FHIR Specification (v3.0.2: STU 3). The current version which supercedes this version is 5.0.0 . For a full list Continuous Integration Build of available versions, see FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions icon . Page versions: R5 R4B R4 R3 R2

Using Codes Code Systems Value Sets Concept Maps Identifier Systems

4.3.1.28 4.4.1.319 Value Set ValueSet http://hl7.org/fhir/ValueSet/marital-status

  Maturity Level : 5
Responsible Owner: Patient Administration icon Work Group Informative Normative (from v4.0.0) Use Context : Not Intended for Production use Country: World
This is a value set defined by the FHIR project. Summary
  • Defining URL: Narrative http://hl7.org/fhir/ValueSet/marital-status
  • XML Name:
  • Marital Status Codes JSON
  • Definition: TTL This value set defines the set of codes that can be used to indicate the marital status of a person.
OID:
Official URL : Committee: http://hl7.org/fhir/ValueSet/marital-status Work Group Version : 6.0.0-ballot3
active as of 2025-11-14 2.16.840.1.113883.4.642.3.28 (for OID based terminology systems) Computable Name : MaritalStatusCodes
Source Resource Flags : XML / JSON OID : 2.16.840.1.113883.4.642.3.29

This value set is used in the following places:

4.3.1.28.1 4.4.1.319.1 Definition

This value set defines the set of codes that can be used to indicate the marital status of a person.

4.4.1.319.2 Content Logical Definition

Generated Narrative: ValueSet marital-status

Last updated: 2025-11-14T20:54:02.388Z

This value set includes codes from based on the following code systems: rules:

  • Include all codes defined in http://hl7.org/fhir/v3/MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus icon version 📦3.0.0
  • Include these codes as defined in http://hl7.org/fhir/v3/NullFlavor http://terminology.hl7.org/CodeSystem/v3-NullFlavor icon version 📦3.0.0
    Code Display Definition
    UNK icon unknown Description:A **Description:**A proper value is applicable, but not known.
    Usage Notes:
    **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". "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" "H" and a URL prefix of "tel:" "tel:" to convey that it is the home phone number that is unknown.)

 

4.3.1.28.2 4.4.1.319.3 Expansion

This expansion generated 19 Apr 2017 14 Nov 2025

ValueSet

This value set contains 11 12 concepts

Expansion based on http://hl7.org/fhir/v3/NullFlavor version 2016-11-11, http://hl7.org/fhir/v3/MaritalStatus version 2016-11-11
Code System System Code Display Definition
A http://terminology.hl7.org/CodeSystem/v3-MaritalStatus    A icon http://hl7.org/fhir/v3/MaritalStatus Annulled

Marriage contract has been declared null and to not have existed

D http://terminology.hl7.org/CodeSystem/v3-MaritalStatus    D icon http://hl7.org/fhir/v3/MaritalStatus Divorced

Marriage contract has been declared dissolved and inactive

I http://terminology.hl7.org/CodeSystem/v3-MaritalStatus    I icon http://hl7.org/fhir/v3/MaritalStatus Interlocutory

Subject to an Interlocutory Decree.

L http://terminology.hl7.org/CodeSystem/v3-MaritalStatus    L icon http://hl7.org/fhir/v3/MaritalStatus Legally Separated Legally Separated
M http://terminology.hl7.org/CodeSystem/v3-MaritalStatus    M icon http://hl7.org/fhir/v3/MaritalStatus Married

A current marriage contract is active

P http://terminology.hl7.org/CodeSystem/v3-MaritalStatus    C icon http://hl7.org/fhir/v3/MaritalStatus Polygamous Common Law More than 1 current spouse

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.

S http://terminology.hl7.org/CodeSystem/v3-MaritalStatus    P icon http://hl7.org/fhir/v3/MaritalStatus Never Married Polygamous No marriage contract has ever been entered

More than 1 current spouse

T http://terminology.hl7.org/CodeSystem/v3-MaritalStatus    T icon http://hl7.org/fhir/v3/MaritalStatus Domestic partner

Person declares that a domestic partner relationship exists.

U http://terminology.hl7.org/CodeSystem/v3-MaritalStatus    U icon http://hl7.org/fhir/v3/MaritalStatus unmarried

Currently not in a marriage contract.

W http://terminology.hl7.org/CodeSystem/v3-MaritalStatus    S icon Never Married

No marriage contract has ever been entered

http://hl7.org/fhir/v3/MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus    W icon Widowed

The spouse has died

UNK http://terminology.hl7.org/CodeSystem/v3-NullFlavor    UNK icon http://hl7.org/fhir/v3/NullFlavor unknown Description:A

**Description:**A proper value is applicable, but not known.

Usage Notes: 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". "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" "H" and a URL prefix of "tel:" "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:

Level Lvl A few code lists that FHIR defines are hierarchical - each code is assigned a level. In this scheme, some codes For value sets, levels are under other codes, and imply that the mostly used to organize codes for user convenience, but may follow code they are under also applies 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