# Living Arrangement (2.8.2 - 1.1.0) - HL7 v2.8.2 Vocabulary v0.2.0

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **Living Arrangement (2.8.2 - 1.1.0)**

## CodeSystem: Living Arrangement (2.8.2 - 1.1.0) (Experimental) 

| | |
| :--- | :--- |
| *Official URL*:http://terminology.hl7.org/v2plusvocab/CodeSystem/livingArrangement | *Version*:1.1.0 |
| Active as of 2026-03-13 | *Computable Name*:LivingArrangement |
| *Other Identifiers:*OID:2.16.840.1.113883.18.122, urn:ietf:rfc:3986#Uniform Resource Identifier (URI)#http://terminology.hl7.org/v2plusvocab/CodeSystem/v2-0220 | |
| **Copyright/Legal**: HL7 Inc., 2026 | |

 
Code system of concepts characterizing the situation that patient-associated parties live in at their residential address. Used in HL7 Version 2.x messaging in the NK1 and PD1 segments. 

 This Code system is referenced in the content logical definition of the following value sets: 

* [Hl7VSlivingArrangement](ValueSet-hl7VSlivingArrangement.md)



## Resource Content

```json
{
  "resourceType" : "CodeSystem",
  "id" : "livingArrangement",
  "extension" : [{
    "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-v2versionCreated",
    "valueString" : "2.8.2"
  },
  {
    "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-versionHistory",
    "valueString" : "generate correct history somehow"
  },
  {
    "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-tableNo",
    "valueString" : "0220"
  }],
  "url" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/livingArrangement",
  "identifier" : [{
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.18.122"
  },
  {
    "system" : "urn:ietf:rfc:3986",
    "value" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/v2-0220"
  }],
  "version" : "1.1.0",
  "name" : "LivingArrangement",
  "title" : "Living Arrangement (2.8.2 - 1.1.0)",
  "status" : "active",
  "experimental" : true,
  "date" : "2026-03-13T11:11:43+00:00",
  "publisher" : "HL7/FO",
  "contact" : [{
    "name" : "HL7/FO",
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org"
    }]
  }],
  "description" : "Code system of concepts characterizing the situation that patient-associated parties live in at their residential address.  Used in HL7 Version 2.x messaging in the NK1 and PD1 segments.",
  "copyright" : "HL7 Inc., 2026",
  "caseSensitive" : true,
  "compositional" : false,
  "content" : "complete",
  "property" : [{
    "code" : "versionIntroduced",
    "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionIntroduced",
    "description" : "version when was this code introduced",
    "type" : "string"
  },
  {
    "code" : "versionDeprecated",
    "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionDeprecated",
    "description" : "version when was this code deprecated",
    "type" : "string"
  },
  {
    "code" : "status",
    "uri" : "http://hl7.org/fhir/concept-properties#status",
    "description" : "A code that indicates the status of the concept. Typical values are active, experimental, deprecated, and retired",
    "type" : "code"
  },
  {
    "code" : "comment",
    "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#comment",
    "description" : "A string that provides additional detail pertinent to the use or understanding of the concept",
    "type" : "string"
  },
  {
    "code" : "usage",
    "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#usage",
    "description" : "usage notes for this code",
    "type" : "string"
  },
  {
    "code" : "modified",
    "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#modified",
    "description" : "date of last modification",
    "type" : "dateTime"
  }],
  "concept" : [{
    "code" : "A",
    "display" : "Alone",
    "definition" : "Alone",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.3"
    }]
  },
  {
    "code" : "F",
    "display" : "Family",
    "definition" : "Family",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.3"
    }]
  },
  {
    "code" : "I",
    "display" : "Institution",
    "definition" : "Institution",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.3"
    }]
  },
  {
    "code" : "R",
    "display" : "Relative",
    "definition" : "Relative",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.3"
    }]
  },
  {
    "code" : "S",
    "display" : "Spouse Only",
    "definition" : "Spouse Only",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.3"
    }]
  },
  {
    "code" : "U",
    "display" : "Unknown",
    "definition" : "Unknown",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.3"
    }]
  }]
}

```
