Listen for hospital admission updates

Listening for hospital admission updates is useful if you want to know about movements within a specific hospital. Typically, you can use this API action so that you are notified when any of these events occur within your connection’s EHR system:

  • A patient is admitted to the hospital.
  • A patient is transferred to a different department of the hospital.
  • A patient is discharged from the hospital.

A notification is triggered anytime there is an admission, transfer, or discharge for an individual patient within the hospital.

Supported systems

You can receive notifications like this with the Redox FHIR® API.

Your connection's system can push notifications with a polling or subscription type of system. 

Things you need to know

Action steps

Listen for patient registration updates

For patient registration, the EHR system sends a notification when a patient's demographics are updated during an inpatient or outpatient visit.

To review technical specifications for this notification, refer to the Patient Registered schema.

Notification
{
"id": "PatientAdminEventPatientRegisteredBundleExample",
"type": "message",
"entry": [
{
"resource": {
"id": "RedoxMessageHeaderExample",
"source": {
"name": "Good Health Clinics",
"endpoint": "05107c08-fe2f-4740-8c1d-c7107d18ebe5"
},
"eventCoding": {
"code": "PatientAdmin-event-patient-registered",
"system": "urn:redox:event-type"
},
"resourceType": "MessageHeader"
}
},
{
"fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Patient?identifier=urn:redox:redox-fhir-sandbox:MR|kyHGADnvX3xbkU4V9ayaqh",
"resource": {
"resourceType": "Patient"
}
},
{
"fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Encounter?identifier=urn:redox:encounterId|zzz123Encounter",
"resource": {
"class": {
"code": "AMB",
"system": "http://terminology.hl7.org/ValueSet/v3-ActEncounterCode"
},
"status": "planned",
"resourceType": "Encounter"
}
}
],
"timestamp": "2021-06-17T20:33:22.422Z",
"resourceType": "Bundle"
}

Listen for patient preadmit notifications

The EHR system sends a notification whenever a reservation is made for a hospital procedure or visit:

  • A patient makes an appointment for a surgery.
  • An L&D appointment is made for a patient.
  • A patient arrives at the ER and is triaged, prior to being officially admitted into a room for care.

To review technical specifications for this notification, refer to the Patient Pre Admitted schema.

Notification
{
"resourceType": "Bundle",
"id": "PatientAdminEventPatientPreAdmittedBundleExample",
"type": "message",
"timestamp": "2021-12-17T20:33:22.422Z",
"entry": [
{
"resource": {
"resourceType": "MessageHeader",
"id": "RedoxMessageHeaderExample",
"source": {
"name": "Good Health Clinics",
"endpoint": "05107c08-fe2f-4740-8c1d-c7107d18ebe5"
},
"eventCoding": {
"system": "urn:redox:event-type",
"code": "PatientAdmin-event-patient-pre-admitted"
}
}
},
{
"fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Patient?identifier=urn:redox:redox-fhir-sandbox:MR|kyHGADnvX3xbkU4V9ayaqh",
"resource": {
"resourceType": "Patient"
}
},
{
"fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Encounter?identifier=urn:redox:encounterId|zzz123Encounter",
"resource": {
"resourceType": "Encounter",
"status": "planned",
"class": {
"code": "AMB",
"system": "http://terminology.hl7.org/ValueSet/v3-ActEncounterCode"
}
}
}
]
}

Listen for patient arrival notifications

The EHR system sends a notification for each individual patient that checks in for a hospital or outpatient visit. To review technical specifications for this notification, refer to the Patient Arrived schema.

Notification
{
"id": "PatientAdminEventPatientArrivedBundleExample",
"type": "message",
"entry": [
{
"resource": {
"id": "RedoxMessageHeaderExample",
"source": {
"name": "Good Health Clinics",
"endpoint": "05107c08-fe2f-4740-8c1d-c7107d18ebe5"
},
"eventCoding": {
"code": "PatientAdmin-event-patient-arrived",
"system": "urn:redox:event-type"
},
"resourceType": "MessageHeader"
}
},
{
"fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Patient?identifier=urn:redox:redox-fhir-sandbox:MR|kyHGADnvX3xbkU4V9ayaqh",
"resource": {
"resourceType": "Patient"
}
},
{
"fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Encounter?identifier=urn:redox:encounterId|zzz123Encounter",
"resource": {
"class": {
"code": "AMB",
"system": "http://terminology.hl7.org/ValueSet/v3-ActEncounterCode"
},
"status": "arrived",
"resourceType": "Encounter"
}
}
],
"timestamp": "2021-06-17T20:33:22.422Z",
"resourceType": "Bundle"
}

Listen for patient transfer notifications

The EHR system sends a notification whenever a patient is transferred to another department within the hospital (e.g., from the ER to ICU). To review technical specifications for this notification, refer to the Patient Transferred schema.

Notification
{
"resourceType": "Bundle",
"id": "PatientAdminEventPatientTransferredBundleExample",
"type": "message",
"timestamp": "2021-06-17T20:33:22.422Z",
"entry": [
{
"resource": {
"resourceType": "MessageHeader",
"id": "RedoxMessageHeaderExample",
"source": {
"name": "Good Health Clinics",
"endpoint": "05107c08-fe2f-4740-8c1d-c7107d18ebe5"
},
"eventCoding": {
"system": "urn:redox:event-type",
"code": "PatientAdmin-event-patient-transferred"
}
}
},
{
"fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Patient?identifier=urn:redox:redox-fhir-sandbox:MR|kyHGADnvX3xbkU4V9ayaqh",
"resource": {
"resourceType": "Patient"
}
},
{
"fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Encounter?identifier=urn:redox:encounterId|zzz123Encounter",
"resource": {
"resourceType": "Encounter",
"status": "in-progress",
"class": {
"code": "AMB",
"system": "http://terminology.hl7.org/ValueSet/v3-ActEncounterCode"
}
}
}
]
}

Listen for patient discharge notifications

The EHR system sends a notification for each patient that is discharged from the hospital. To review technical specifications for this notification, refer to the Patient Discharged schema.

Notification
{
"resourceType": "Bundle",
"id": "PatientAdminEventPatientDischargedBundleExample",
"type": "message",
"timestamp": "2021-06-17T20:33:22.422Z",
"entry": [
{
"resource": {
"resourceType": "MessageHeader",
"id": "RedoxMessageHeaderExample",
"source": {
"name": "Good Health Clinics",
"endpoint": "05107c08-fe2f-4740-8c1d-c7107d18ebe5"
},
"eventCoding": {
"system": "urn:redox:event-type",
"code": "PatientAdmin-event-patient-discharged"
}
}
},
{
"fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Patient?identifier=urn:redox:redox-fhir-sandbox:MR|kyHGADnvX3xbkU4V9ayaqh",
"resource": {
"resourceType": "Patient"
}
},
{
"fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Encounter?identifier=urn:redox:encounterId|zzz123Encounter",
"resource": {
"resourceType": "Encounter",
"status": "finished",
"class": {
"code": "AMB",
"system": "http://terminology.hl7.org/ValueSet/v3-ActEncounterCode"
}
}
}
]
}