HL7 AD Address
HL7 datatype components AD components from HL7 v2.5.1 Hide components
These are the generated components for the version selected at the top of the page. The article stays practical, and this panel follows the chosen HL7 version.
Components
| Pos | Component | Name | Type | Table | Description |
|---|---|---|---|---|---|
| 1 | AD.1 | Street Address | ST | Street Address; Type ST. | |
| 2 | AD.2 | Other Designation | ST | Other Designation; Type ST. | |
| 3 | AD.3 | City | ST | City; Type ST. | |
| 4 | AD.4 | State or Province | ST | State or Province; Type ST. | |
| 5 | AD.5 | Zip or Postal Code | ST | Zip or Postal Code; Type ST. | |
| 6 | AD.6 | Country | ID | 0399 | Country; Type ID; HL7 table 0399. |
| 7 | AD.7 | Address Type | ID | 0190 | Address Type; Type ID; HL7 table 0190. |
| 8 | AD.8 | Other Geographic Designation | ST | Other Geographic Designation; Type ST. |
AD is the older address datatype. In modern HL7 v2 interfaces you are more likely to see XAD, but AD still appears inside older location and address composites. Treat it as a structured address, not a mailing-label string.
In this guide, AD appears in LA1. That used-by list is a good reality check: the datatype is only half the story, and the field that uses it tells you the workflow.
The component panel above is expanded by default because most datatype pages are used as quick lookup pages. Start there for the exact HL7 v2.5.1 shape, then use the notes below for the practical gotchas.
AD-1 to AD-8: Component Quick Read
The generated component panel above is the formal quick lookup. The short version is below so you can scan the shape without counting carets by eye.
The table-backed components here are AD-6, AD-7. Keep those values to the table or value set your implementation guide names, especially when the field is crossing organization boundaries.
- AD-1 Street Address - Street Address. Type ST.
- AD-2 Other Designation - Other Designation. Type ST.
- AD-3 City - City. Type ST.
- AD-4 State or Province - State or Province. Type ST.
- AD-5 Zip or Postal Code - Zip or Postal Code. Type ST.
- AD-6 Country - Country. Type ID. Table 0399.
- AD-7 Address Type - Address Type. Type ID. Table 0190.
- AD-8 Other Geographic Designation - Other Geographic Designation. Type ST.
Practical Notes
Text still has to survive HL7 delimiters. If the source value can contain |, ^, ~, &, or a backslash, encode it before putting it into the message. Integration Soup and the HL7 parser helpers include HL7Encode and HL7Decode for that exact kind of cleanup.
In HL7 Soup Web, click a field that uses AD and the interpretation view will show which component you are sitting in and where that value lives in the raw message. That is especially handy with compact datatypes because one missing caret can move every value after it.
Official and Reference Notes
For formal reference, compare the generated HL7 v2.5.1 panel above with the HL7 v2.5.1 datatype list and the HL7 Terminology data type code system. Local implementation guides can narrow allowed values, tables, and component usage.