Reference·AL1 Segment·AL1-5
HL7 v2 Reference

Understanding HL7 v2 AL1-5: Allergy Reaction in Practice

Jul 27, 2026 · 4 min read
← AL1-4 AL1-6 →

AL1-5 is where allergy data gets messy on purpose, because reactions are described in whatever words the clinician typed. Testing it with a single clean value hides most of the parsing problems it actually causes.

Quick answer

AL1-5 describes the reaction associated with the allergy, such as a symptom or clinical effect. It is a repeating field, so a single allergy can list multiple reactions, and in practice it is populated with a mix of short codes and loosely structured free text.

What this field contains

Structure
Repeating text values — multiple reactions separated by a repetition delimiter, e.g. "HIVES~ANAPHYLAXIS"
Content style
Free text or short mnemonic — varies heavily by source system; rarely standardized
Typical values
Symptom descriptions — e.g. rash, hives, anaphylaxis, nausea, swelling

Example

Synthetic example Generated by Synthibase
AL1|1|DA|PENICILLIN^PENICILLIN^L|SV|HIVES^ANAPHYLAXIS|20250314

AL1-5 lists two reactions for this penicillin allergy: hives and anaphylaxis, separated by a component delimiter in this example.

Where this trips people up

The delimiter question is the biggest source of bugs here. Some source systems repeat AL1-5 using the HL7 repetition separator, others cram multiple reactions into one string using a component or subcomponent separator, and some just write a long free-text sentence with no structure at all. A parser tested against only one of these patterns will drop or garble reactions the first time it meets a different one. It is also worth testing wildly inconsistent capitalization and spelling, since this field is rarely normalized against a controlled vocabulary before it hits your interface.

HL7 v2 AL1 Segment Guide: Fields, Format, and Testing Gotchas
How to Build a Synthetic Patient Registry for Healthcare Testing
Healthcare API Testing Guide: FHIR and X12
Generate reactions the way real systems send them
Synthibase varies AL1-5 across delimiter styles, free text, and multi-reaction lists so your parsing logic gets tested against realistic inconsistency, not just one clean pattern.
Start free trial →
This page is written independently by Synthibase for testing and informational purposes. It is not an official publication of HL7 International or X12/Washington Publishing Company, and is not a substitute for reviewing the official standard or your trading partner's companion guide. See our Terms of Service for full legal terms.