Scan

Beta
GET

Scans up to 100 appointment updates. The since query parameter is inclusive, and the result list is ordered by updatedAt ascending.

Query parameters

sincedatetimeRequired

Response

This endpoint returns a list of objects.
deactivatedboolean

True if the appointment is deactivated. Deactivated appointments are not returned in search results but are returned in all other endpoints including scan.

idstring

The unique identifier for an Appointment.

organization_idstring

The organization that owns this appointment.

patient_idstring

The Candid-defined patient identifier.

service_durationinteger

The requested length of time allotted for the appointment. The units are in minutes.

serviceslist of objects
start_timestampdatetime
updated_atdatetime
updating_user_idstring

The user ID of the user who last updated the appointment.

versioninteger

The version of the appointment. Any update to any property of an appointment object will create a new version.

attending_doctorobjectOptional

Attending physician information. The attending physician will be stored as the Current MD for the patient.

automated_eligibility_check_completebooleanOptional

True if the automated eligibility check has been completed. It is not recommended to change this value manually via API. This refers explicitly to the automated eligibility check that occurs a specific number of days before the appointment.

checked_in_timestampdatetimeOptional

The timestamp when the patient checked in for their appointment. If status is CHECKED_IN, checked_in_timestamp must be set. If checked_in_timestamp is set, status must be CHECKED_IN.

estimated_copay_centsintegerOptional
estimated_patient_responsibility_centsintegerOptional
location_resource_idstringOptional
Contains the coded identification of the location being scheduled. Components: <Identifier (ST)>^<Text (ST)>
notesstringOptional
patient_deposit_centsintegerOptional
placer_appointment_idstringOptional

ID for the appointment/order for the event.

statusenumOptional
Allowed values: PENDINGNOT_READYREADYCHECKED_IN

Defaults to PENDING. If status is NOT_READY, work_queue must be set. If status is READY or CHECKED_IN, work_queue must be null. If status is CHECKED_IN, checked_in_timestamp must be set. If checked_in_timestamp is set, status must be CHECKED_IN.

work_queueenumOptional
Allowed values: EMERGENT_ISSUENEW_PATIENTRETURNING_PATIENT

The work queue that the appointment belongs to. It is not recommended to change this value manually via API. If status is NOT_READY, work_queue must be set. If status is READY or CHECKED_IN, work_queue must be null.

Built with