HL7 101 — Required field missing
Code 101 means a field the receiver requires was empty. This is one of the most common HL7 errors and is almost always correctable by populating the field and resending.
When you see 101 (Error Condition Code)
Raised when a required field — by the standard or by the receiver's interface specification — is blank. ERR-7/ERR-8 usually name the exact location (e.g. PID.3, PID.5, PV1.7).
Common causes
- Patient identifier (PID-3) or patient name (PID-5) is empty.
- A field the receiver marks as required in its spec (even if optional in the standard) was not sent.
- An upstream system left a field blank that the downstream system depends on.
- A transformation cleared a field while reformatting.
How to fix it
- 1Read ERR-7/ERR-8 (or the diagnostic text) to find the exact field location, then ensure the sending system populates it.
- 2Reconcile the two systems' interface specifications — a field required by the receiver but optional upstream must be mapped or defaulted.
- 3Add a validation check in the interface engine to catch the empty field before transmission.
Example ACK message
A representative acknowledgment carrying ERR-3 = 101. Open it in the HL7 Viewer to inspect every field.
1MSH||^~\&|RECEIVER|HOSP|SENDER|HOSP|20260310143410||ACK^A01^ACK|ACK00011|P|2.5.1 2MSA||AE|MSG00001|Required field missing 3ERR||||101^Required field missing^HL70357|E|||PID.5 (Patient Name) is required but was empty
Related codes
Code 102 means a field contained a value of the wrong data type — for example text where a number or a properly formatted date/timestamp was expected.
Code 100 means the segments arrived in an order the receiver did not expect, or a required segment was missing from its expected position in the message structure.
Frequently asked questions
How do I fix HL7 error code 101?
Code 101 (Required field missing) means a field the receiver requires is empty. Read ERR-7/ERR-8 to find the exact field (often PID.3 or PID.5), populate it in the sending system or interface mapping, and 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 →