API users now have the ability to create and update patient cases, which document patient communications outside an encounter. Patient cases allow practices to document patient calls or calls about patients directly in athenaNet while the caller is on the phone. Examples of patient cases include billing questions, prescription refills request, and clinical questions. Once a patient case is created, it will route to the proper provider or staff member depending on the subject to be reviewed and addressed.
Creating Patient Cases
When creating patient cases in athenaNet, only one patient case can be created per API call. The Source field is the individual/entity who is the source of the phone call (i.e. Patient, Pharmacy, Lab, etc.). ProviderID is the ID of the provider for whom the case is intended.
There are optional fields that will help the practice route the patient case to the appropriate person.
Creates a patient case for a patient. PatientID, DepartmentID, ProviderID, and Source are required inputs. The internalnote field houses the body of the patient case message and has a limit of 4000 characters.
The API response for a successfully generated patient case will always indicate Success: True and the PatientCaseID of the newly created patient case.
Editing Patient Cases
Patient cases are also editable, and only one case can be updated per API call. API users will only be able to update patient cases that have been created via API. API users will not be able to update patient cases created in athenaNet by users or by other API users. Additionally, API users will not be able to edit closed or deleted patient cases.
All fields available for creating a patient case are also available for updating. A patientcaseid will be required to update a patient case which can be retrieved with the patientcase API endpoint call. If the field you are editing already had information, it will be overwritten by the edit.
Updates any field for a specific patient case. PatientID and PatientCaseID are required inputs.
The API response for a successfully edited patient case will always indicate Success: True and the PatientCaseID of the edited patient case.