HL7 AR — Application Reject
The receiving application rejected the message and did not process it — typically because of a structural, version, or environmental problem the sender cannot fix by changing one field value.
When you see AR (Acknowledgment Code)
Returned in MSA-1 when the message cannot be accepted at all: an unsupported message type or event, an unsupported HL7 version, a malformed MSH, or a security/processing-ID rejection. Often paired with Table 0357 codes in the 200-range.
Common causes
- Unsupported message type (code 200) or unsupported event code (code 201).
- Unsupported version ID in MSH-12 (code 203) — sender and receiver on different HL7 v2.x versions.
- Unsupported processing ID in MSH-11 (code 202) — e.g. sending P (production) to a system expecting T (test).
- Malformed MSH or missing required separators/encoding characters.
How to fix it
- 1Check the ERR segment for the 200-range Table 0357 code to identify which environmental field was rejected.
- 2Align MSH-9 (message type/event), MSH-11 (processing ID), and MSH-12 (version ID) with what the receiver supports — this is a configuration/interface-spec fix, not a per-message data fix.
- 3Confirm the receiving channel is configured to accept this message type; an interface engine filter may be rejecting it before the application sees it.
Example ACK message
A representative acknowledgment carrying MSA-1 = AR. Open it in the HL7 Viewer to inspect every field.
1MSH||^~\&|RECEIVER|HOSP|SENDER|HOSP|20260310143320||ACK^A01^ACK|ACK00003|P|2.5.1 2MSA||AR|MSG00001|Message rejected 3ERR||||203^Unsupported version id^HL70357|E|||MSH.12 version 2.3 not supported; receiver expects 2.5.1
Related codes
The receiving application successfully received, understood, and processed the message.
The receiving application understood the message but could not process it because of an error in the message content or an application-level failure.
In enhanced acknowledgment mode, CR indicates the receiver rejected the message at the accept (commit) level — typically because the message header or framing was unacceptable before any application processing.
Frequently asked questions
What does AR mean in an HL7 ACK?
AR in MSA-1 means Application Reject — the receiving application rejected the message outright, usually due to an unsupported message type, event, version, or processing ID. It is an environment/configuration issue rather than a single bad field.
Should I retry a message that got an AR?
Not as-is. AR rejections are caused by structural or configuration mismatches (version, message type, processing ID), so resending the same message produces the same AR. Fix the interface configuration or message header first, then resend.
Debug your ACK in the viewer
Paste the ACK (or original message) and get instant segment parsing, MSA/ERR decoding, and validation. Free, client-side, no signup.
Open HL7 Message Viewer →All HL7 error & ACK codes
Browse every acknowledgment code (Table 0008) and error condition code (Table 0357) with causes, fixes, and examples.
HL7 Error Code Reference →