GetProposedTimeSlots

Gets proposed time slots according to given filters

JavaScript library method 

patientportal.appointment.getProposedTimeSlots({
    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>,
    payerType: <payer-type>,
    patient: <patient>,
    referral: <referral>,
    recall: <recall>,
    modules: <modules>,
    services: <services>
});

HTTP Method

Verb URL
GET /patientportalapi/appointment/proposed-time-slots

URL Parameters

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

The end date/time for the search (exclusive).

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:mm”

(optional)

Time filter for the appointment start time. E.g 09:30.

time-to

string “HH:mm”

(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.

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

TimeSlotsData

Remarks

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