Department-Based Patient Information

Partners are now able to search for a patient within a specified practice Department. When a Department ID is provided as an input parameter, the API will return patient information found in the specified department. For example, suppose an enterprise context had two entries for patient James Smith, one with Patient ID 100 in Department 101, and the other with Patient ID 200 in Department 202. In this case, Patient ID 100 is the primary record for Mr. Smith, referred to as his canonical Patient ID. Partners can use either the canonical or a Department-specific Patient ID when using the GET /patients/{patientid} API.

Prior to this change, if a partner called GET /patients/100 or GET /patients/200, the API would always return data for the canonical version of Mr. Smith. With these changes, partners can specify both the Patient ID and the Department ID and the API will return data for the Department-specific version of the patient. Now, when a partner asks for the version of the patient in Department 202, the API will return information from Patient 200, rather than always returning information about the canonical version of the patient.

When the input parameter SHOWALLPATIENTDEPARTMENTSTATUS is set to True, GET /patients/{patientid} will return all applicable Department IDs and Primary Provider IDs for the specified patient. This enhancement makes is easier for partners to identify all versions of a patient throughout the enterprise.

In addition, when updating patient information with PUT /patients/{patientid}, partners can now update the Department-specific version of the patient by passing the applicable Department ID in the LOOKUPDEPARTMETNTID parameter.

Note: Not all patient information fields have different values across all Departments.To see which fields are shared across patients in different Departments (and therefore will always have the same value across all versions of a Patient), review the values set for setting for CPI Shared Patient Fields in athenaNet under Gear- ADMIN – Implementation – PRACTICE LINKS – Client Functions – Settings. Also, the Patient ID value returned in the API output will always be the canonical ID, even if a different patient ID is passed as an input parameter.

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others