Get list of patients by disaster

[malak-coforma]

Description

Endpoint	acme/patient/list
Method	GET
Possible Parameters	disasterId (int)
Roles	EHR Maintainer, Government Systems Coordinator, Facility System Administrator

Get a list of all patients by a specific disaster

User Story (EHR Maintainer)

As a EHR Maintainer
I want to see all patients impacted by a disaster
So that I can ensure that I am reporting on patients accurately
Because I am responsible for reporting on patient status in the EHR.

User Story (Government Systems Coordinator)

As a Government Systems Coordinator
I want to see all patients impacted by a disaster
So that I can see more than just their current status
Because I am responsible for validating, verifying, or auditing reimbursement to facilities based on number of patients affected.

We believe that the GSC would need access to individual patient ID's here to assist in auditing, and access to that potential PII/PHI would be warranted here.

User Story (Facility System Administrator)

As a Facility System Administrator
I want to see all patients impacted by a disaster
So that I can ensure the API is accurately reporting data to CMS
Because I am responsible for API connectivity and integration.

GET Parameters

Parameter	Data Type	Optional?
disasterId	int	REQUIRED

Response Body

200

[
  { "patientId": int, "facilityId": int },
  { "patientId": int, "facilityId": int },
  { "patientId": int, "facilityId": int },
  ...
]

400

If request body sent is syntactically invalid.

If request body sent is not processable (missing or malformed data).

403

This endpoint is not authorized for roles who are not EHR maintainers or Government Systems Coordinators.

Acceptance Criteria

1. Returns 200 with response body when well-formatted data is sent by an EHR Maintainer or Government Systems Coordinator.
2. Returns 400 if request body is malformed.
3. Returns 400 if request body is missing required data.
4. Returns 400 if the request body contains data that doesn't make sense.
5. Returns 403 if request is made by a role other than an EHR Maintainer or Government Systems Coordinator.

Tech Notes

Overall schema plan (Lucidchart)