Skip to main content
HL7 ADT (Admit, Discharge, Transfer) messages represent key events in a patient’s journey through a healthcare facility. Each message carries an event type code that identifies the phase of care. The receiver processes all ADT event types through a unified pipeline and stores the event type with the visit record.

Event types

Admission (A01) The patient has been formally admitted to the facility. This is typically the first event in an inpatient encounter and creates the visit record with location, attending doctor, and hospital service. Transfer (A02) The patient has been moved from one department, unit, or bed to another. Transfer messages update the visit’s location and may change the responsible care team. Discharge (A03) The end of a patient’s stay. Discharge messages may omit some segments (e.g. insurance, next-of-kin) that were present earlier. The receiver keeps previously stored insurance and next-of-kin data when a discharge message omits them, so no data is lost. Registration (A04) Outpatient or pre-admission registration. It records the patient’s intent to receive care without a formal inpatient admission. Update Patient Information (A08) Sent when a patient’s demographic information changes (e.g. address, contact, insurance) outside an admission or discharge. Cancel Admission (A11) Reverses a prior admission (e.g. recorded in error or status changes before care begins). Cancel Transfer (A12) Reverses a prior transfer and restores the patient’s previous location and care assignment. Cancel Discharge (A13) Reverses a prior discharge and reinstates the patient as an active inpatient (e.g. discharge recorded too early or in error).
For authentication credentials and access setup, contact the medWrite team.

Next steps

Send HL7 Message

Connection, message format, and ACK behaviour.

API Introduction

Overview of the MedWrite API.