GetProposedAppointments

Gets proposed appointments according given filters.

JavaScript library method

patientportal.appointment.getProposedAppointments({
    appointmentType: <appointment-type>,
    clinician: <clinician>,
    clinicianSex: <clinician-sex>,
    site: <site>,
    location: <location>,
    fromDate: <from-date>,
    toDate: <to-date>,
    timePreference: <time-preference>,
    timeFrom: <time-from>,
    timeTo: <time-to>,
    modules: <modules>,
    payerType: <payer-type>,
    patient: <patient>,
    referral: <referral>,
    recall: <recall>,
    numberOfResults: <number-of-results>
});

HTTP Method

Verb URL
POST /patientportalapi/appointment/proposed

URL Parameters

Parameter Type Description
appointment-type string Type of the appointment provided by the API upon GetAppointmentTypes.
clinician int (optional) Clinician filter. Identifier provide by the API upon GetClinicians. Allow 0 for any clinician.
clinician-sex int (optional)

Clinician’s gender filter:

  • 0 = any sex
  • 1 = male
  • 2 = female
site int (optional) Site filter. Identifier provide by the API upon GetSites. Allow 0 for any site.
location int (optional) Location filter. Identifier provide by the API upon GetSites. Allow 0 for any location.
from-date LocalDateTime (optional)

Filters appointments on or after provided date/time (inclusive).

The parameter is a local date/time on a site. If you search across multiple sites in different time zones the search looks for the local date/time at each site.

to-date LocalDateTime (optional)

The end date/time for the search (exclusive). If not provided the API is looking for days/months into the future to satisfy the requested number-of-results. This may take some time. If you need to get slots for a specific day only it is recommended to provide to-date to make the request quick.

time-preference int (optional)

Preferred time filter:

  • 0 = any time
  • 1 = Morning 00:00 – 12:00
  • 2 = Afternoon 12:00 – 00:00

Note this parameter is ignored if any from time-from or time-to are provided.

time-from string “HH:ss” (optional) Time filter for the appointment start time. E.g 09:30.
time-to string “HH:ss” (optional) Time filter for the appointment finish time. E.g 11:00.
payer-type string (optional) Type of the payer provided by the API upon GetPayerTypes.
patient string (optional)

The key of the patient provided by the API upon section Patients.

Used to book an appointment for a different patient within your company. Default is the logged in patient.

referral string (optional)

The key of the referral provided by the API upon GetReferrals.

Used to book an appointment for a specific referral.

recall string (optional)

The key of the recall provided by the API upon method GetRecalls.

Used to book an appointment for a specific recall.

number-of-results int (optional) Required number of proposed slots. Value must be in a range 1 – 100.

POST Parameters

Parameter Type Description
modules AppointmentModuleData[] (optional) Selection of modules and additional services provided by the API upon GetAppointmentTypes.
services ServiceData[] (optional) Selection of services provided by GetServices

Returns

AppointmentData[]

Remarks

The server sorts the result by day and time of the appointment (the soonest appointment first).