Encounter is a administrative FHIR Resource to record an interaction between a patient and healthcare providers for the purpose of providing healthcare services or assessing the health status of a patient.
Accessing a patient's encounter can aid in workflows such as understanding a patient's history of care and identifying gaps in care.
Many payers make this available in a basic form derived from a patient's claims, but some also provide a more detailed view of the patient's encounters if they have a more robust provider-payer clinical data exchange, such as quality measures.
The full list of search parameters can be found here. Some of the most important are:
The ID of the patient who participated in the encounter. We recommend using this search parameter along with the
The date of the encounter.
The type of the encounter.
While some servers may support a resource-level search without any parameters, not all do. We recommend using the format below with the patient ID via the
$PATIENT_ID wildcard as a search parameter.
This is a sample request using
curl "https://api.flexpa.com/fhir/Encounter?patient=$PATIENT_ID" \
-H "Authorization: Bearer $ACCESS_TOKEN"
This is a sample response from UnitedHealthcare using Flexpa API in test mode