HL7 v2.9 Vocabulary
0.1.0 - ci-build

HL7 v2.9 Vocabulary, published by HL7/FO. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/frankoemig/hl7.v2.terminology.v29/ and changes regularly. See the Directory of published versions

## 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-01-27 | Computable Name: AddressUsage
Other Identifiers: OID:2.16.840.1.113883.18.375
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

Properties

This code system defines the following properties for its concepts

Name | Code | URI | Type | Description
versionIntroduced | versionIntroduced | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionIntroduced | string | version when was this code introduced
versionDeprecated | versionDeprecated | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionDeprecated | string | version when was this code deprecated
status | status | http://hl7.org/fhir/concept-properties#status | code | A code that indicates the status of the concept. Typical values are active, experimental, deprecated, and retired
comment | comment | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#comment | string | A string that provides additional detail pertinent to the use or understanding of the concept
usage | usage | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#usage | string | usage notes for this code
modified | modified | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#modified | dateTime | date of last modification

Concepts

This case-sensitive code system `http://terminology.hl7.org/v2plusvocab/CodeSystem/addressUsage` defines the following codes:

Code | Display | Definition | versionIntroduced | comment | modified
C | Classification | Classification | 2.6 | 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. | 2015-07-13
M | Mailing | Mailing | 2.6 | Identifies an address for mail correspondence from a healthcare provider as stipulated by the subject. For 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.) | 2015-07-13
V | Visit | Visit | 2.6 | Identifies an address at which the individual is physically located and may be visited. | 2015-07-13