US Veterans Health Administration FHIR Map Set Implementation Guide
1.3.1 - 250401 United States of America flag

Publication Build: This will be filled in by the publication tooling

ValueSet: MaritalStatus FHIR

Official URL: http://va.gov/fhir/ValueSet/MaritalStatus Version: 1.3.1
Active as of 2025-03-31 Computable Name: MaritalStatus

FHIR Target ValueSet for Terminology Maps VF_MaritalStatus

References

This value set contains the valid values for FHIR. The source values from VistA are mapped to these values in the linked ConceptMap.

Logical Definition (CLD)

Generated Narrative: ValueSet MaritalStatus

This value set includes codes based on the following rules:

  • Include these codes as defined in http://terminology.hl7.org/CodeSystem/v3-MaritalStatus
    CodeDisplayDefinition
    DDivorcedMarriage contract has been declared dissolved and inactive
    MMarriedA current marriage contract is active
    SNever MarriedNo marriage contract has ever been entered
    LLegally Separated
    WWidowedThe spouse has died
  • Include these codes as defined in http://terminology.hl7.org/CodeSystem/v3-NullFlavor
    CodeDisplayDefinition
    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.)

 

Expansion

ValueSet

This value set contains 6 concepts

CodeSystemDisplay (en-US)Definition
  Dhttp://terminology.hl7.org/CodeSystem/v3-MaritalStatus

Marriage contract has been declared dissolved and inactive

  Mhttp://terminology.hl7.org/CodeSystem/v3-MaritalStatus

A current marriage contract is active

  Shttp://terminology.hl7.org/CodeSystem/v3-MaritalStatus

No marriage contract has ever been entered

  Lhttp://terminology.hl7.org/CodeSystem/v3-MaritalStatus
  Whttp://terminology.hl7.org/CodeSystem/v3-MaritalStatus

The spouse has died

  UNKhttp://terminology.hl7.org/CodeSystem/v3-NullFlavor

**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.)

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