# Address Usage (2.9 - 1.0.1) - HL7 v2.9 Vocabulary v0.2.0

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **Address Usage (2.9 - 1.0.1)**

## CodeSystem: Address Usage (2.9 - 1.0.1) (Experimental) 

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

 
HL7-defined code system of concepts specifying how an address is intended to be used. Used in HL7 Version 2.x messaging in the XAD segment. 

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

* [Hl7VSaddressUsage](ValueSet-hl7VSaddressUsage.md)



## Resource Content

```json
{
  "resourceType" : "CodeSystem",
  "id" : "addressUsage",
  "extension" : [{
    "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-v2versionCreated",
    "valueString" : "2.9"
  },
  {
    "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-versionHistory",
    "valueString" : "generate correct history somehow"
  },
  {
    "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-tableNo",
    "valueString" : "0617"
  }],
  "url" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/addressUsage",
  "identifier" : [{
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.18.375"
  },
  {
    "system" : "urn:ietf:rfc:3986",
    "value" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/v2-0617"
  }],
  "version" : "1.0.1",
  "name" : "AddressUsage",
  "title" : "Address Usage (2.9 - 1.0.1)",
  "status" : "active",
  "experimental" : true,
  "date" : "2026-03-13T11:11:50+00:00",
  "publisher" : "HL7/FO",
  "contact" : [{
    "name" : "HL7/FO",
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org"
    }]
  }],
  "description" : "HL7-defined code system of concepts specifying how an address is intended to be used.  Used in HL7 Version 2.x messaging in the XAD segment.",
  "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" : "C",
    "display" : "Classification",
    "definition" : "Classification",
    "property" : [{
      "code" : "comment",
      "valueString" : "Identifies an address used for the purpose of demographic classification or searching.  Such addresses frequently contain insufficient information to be used as mailing or visit addresses.  For example, they may only indicate country and postal code, without providing a street address."
    },
    {
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.6"
    }]
  },
  {
    "code" : "M",
    "display" : "Mailing",
    "definition" : "Mailing",
    "property" : [{
      "code" : "comment",
      "valueString" : "Identifies an address for mail correspondence from a healthcare provider as stipulated by the subject.\r\nFor example, under the tenets of certain privacy regulations, it is exclusive to the patient and is typically maintained at the encounter or visit level versus the person level as it only has relevance to the specifics of a given encounter.  This is an exception category of address in that the patient has stipulated that they want all correspondence relevant to a given encounter sent to this address in lieu of any other address on file.  Providers are required to accommodate such requests under HIPAA promulgated regulation.  Note that mailing and legal address may be mutually exclusive as defined below.  (Implementors are reminded that although the privacy regulation requires the provider to honor such requests, it does require the provider to enquire whether the patient has a preferred address other than the one volunteered.)"
    },
    {
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.6"
    }]
  },
  {
    "code" : "V",
    "display" : "Visit",
    "definition" : "Visit",
    "property" : [{
      "code" : "comment",
      "valueString" : "Identifies an address at which the individual is physically located and may be visited."
    },
    {
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.6"
    }]
  }]
}

```
