Endpoint
Description
Returns an array of appointments with specified status.
Returns a list of appointment objects that were part of the recurring appointment series that specified appointment is part of as determined by the value set in its recurringAppointmentId.
These are the endpoints that are available under the /timeOff path, which shows what hours your staff has taken off. Please note that to create new periods of time off, you POST to the /timeOffBulk path, and also note that you can view multiple time offs by simply posting a GET call to the /appointments/report path with the excludeTimeOff parameter set to false and the onlyTimeOff parameter set to 1. For more information about GET /appointments/report calls, please refer to the Appointments API page.
Parameter
Description
clientId
Displays unique numeric ID of client of appointment to be returned following a GET report call.
Works with the pageNumber parameter to determine how appointments gets returned following a GET report call. The pageSize value represents the number of class sessions appearing on each page of class sessions that gets returned.
PUT /appointments/{appointmentId}
language | js |
---|---|
title | GET /appointments/{appointmentId} |
linenumbers | true |
collapse | true |
Endpoint | Description |
---|---|
GET /appointments/report | Returns all appointment objects on an account in array format. To get time offs to return, set the excludeTimeOff parameter to false and set the onlyTimeOff parameter to 1. |
GET /timeOff/{timeOffId} | Returns a JSON object for specified time off. |
POST /timeOffBulk | Creates a new timeOff object on an' account. Request body/payload: Must pass a full |
PUT /appointments/{appointmentId} | Updates an existing appointment. Request body/payload: Must pass an appointment with the desired changes made. |
PUT /appointments/{appointmentId}/cancel/{sendStaffEmail}/{sendClientEmail} | Sets an appointment to a substatus of CANCEL and alters boolean flag accordingly to notify the client via email. Effectively cancels an appointment with the option to send an email to the staff and the client. Request body/payload: Must pass an appointment object with substatus set to CANCEL. | PUT /appointments/{appointmentId}/noshow/{sendClientEmail} |
Code Block |
---|
{"reason" : ""} |
PUT /appointments/{appointmentId}/completed/{sendClientEmail}
Sets an appointment to a substatus of COMPLETED and alters boolean flag accordingly to send a thank you email to the client.
Request body/payload: Must pass an appointment object with substatus set to COMPLETED.
This endpoint also requires a JSON POST body of an empty string for the Reason property of the appointment:
Code Block |
---|
{"reason" : ""} |
To aid with page load time, we have included pageNumber and pageSize parameters for server side pagination. The pageSize parameter will be the number of items shown per page.
timeOff object. For these calls, you need to pass a timeOff object with all required fields and any fields you want to set filled in the body of the payload. We have an example of a timeOff object in the responses section below and have indicated the required fields in the object values table at the bottom of this page. | |
PUT /timeOff/{timeOffId} | Updates an existing time off object. Request body/payload: Must pass a timeOff object with the desired changes made. For these calls, you need to pass a timeOff object with all required fields and any fields you want to update filled in the body of the payload. We have an example of a timeOff object in the responses section below and have indicated the required fields in the object values table at the bottom of this page. |
DELETE /timeOff/{timeOffId} | Removes a timeOff object from view by setting its active property to false. |
How to Get List of Time Offs
- You set the parameter onlyTimeOff to 1
- The parameter excludeTimeOff is set to false
- the serviceIdList parameter is either sent in as null or only includes ids for reasons that are of reasonType PERSONAL
The objects below represent the minimum viable objects to pass that are needed to create or update a timeOff object. Check whether or not a property can be written to by looking at the Object Values table below to see if the property is writable.
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"appliesTo": "staff",
"assignedTo": "select",
"businessId": "43111",
"endDate": "2019-02-13",
"endTime": "1400",
"reason": {Reason object for reason of time off - for more info, see Services API page},
"repeats": false,
"staffId": [
0: 80891
],
"startDate": "2019-02-13",
"startTime": "1300"
} |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"appliesTo": "staff",
"businessId": 43111,
"changeReason": null,
"clientEndTime": "1400",
"clientStartTime": "1100",
"color": null,
"createdDate": "2019-02-11 17:27:08",
"createdUser": "JoeSchmo",
"description": "Babysitter got sick",
"endDate": "2019-02-13",
"endTime": "1400",
"modifiedDate": "2019-02-11 17:27:08",
"modifiedUser": "JoeSchmo",
"note": "Babysitter got sick",
"reason": {Reason object for reason of time off - for more info, see Services API page},
"recurringAppointmentId": null,
"staff": {Staff object for staff of time off - for more info, see Staff API page},
"staffId": 80891,
"startDate": "2019-02-13",
"startTime": "1300",
"status": "OPEN",
"timeOffId": 20050788
} |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "businessId": 43111, "changeReason": null, "appointmentDateTimeClientcolor": "Thursdaynull, Jul 26, 2018 at 8"createdDate":00 AM FNT "2018-08-03 14:39:38", "appointmentDateTimeStaffcreatedUser": "JoeSchmo"Thursday, Jul 26, 2018 at 8:00 AM FNT"description": "Need a break!", "blockStaffIdListendDate": []"2018-10-01", "blockedStaffListendTime": []1200, "businessIdmodifiedDate": 43111 "2018-08-07 15:10:27", "calendarIdmodifiedUser": 16902079"JoeSchmo", "cancelReasonreason": null, "cancelUser": null, "changeReason": ""{Reason object for reason of time off - for more info, see Services API page}, "classScheduleIdrecurringAppointmentId": null, "clientstaff": {ClientStaff object for clientstaff ofwith appointment-seetime clientsoff API- page},for "clientConfirmedDate": 1532371154462more info, see Staff "clientConfirmed": trueAPI page}, "clientEndDatestartDate": "2018-0710-2501", "clientEndTimestartTime": 9001100, "clientReminderHoursstatus": 1, "clientRescheduleCount": 0"Open", "clientStartDatetimeOffId": "2018-07-26",17360947 } |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
[{ "clientStartTimebusinessId": 80043111, "colorchangeReason": "#668CD9"null, "completedReasoncolor": null, "coordinatorStaffcreatedDate": null"2018-08-03 21:39:38", "couponcreatedUser": null"JoeSchmo", "couponIddescription": null"Need an even longer break!", "createddateendDate": "2018-06-21 14:45:5210-01", "createduserendTime": "JoeSchmo1400", "customFieldDescmodifiedDate": "Comments2018-08-07 : Boo!11:34:56", "datemodifiedUser": "2018-07-26JoeSchmo", "dateCheckedInoriginalStartDate": null"2018-10-01", "dateCompletedreason": null,{Reason object for reason "discount": null, "endDate": "2018-07-26"of time off - for more info, see Services API page}, "endTimerecurringAppointmentId": 930null, "fieldsstaff": {SchedulerStaff fields object for fieldsstaff ofwith fieldstime ofoff appointment-- for more info, see schedulerStaff fields API page}, "invitationUUIdstaffId": null80891, "jobRequisitionIdstartDate": null,"2018-10-01", "locationstartTime": {Location object for location of appointment-see locations API page}"1100", "status": "1100", "locationGrouptimeOffId": {Location group object for location group of appointment-see groups API page}17360947 }}] |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "businessId": 43111, "locationSuperGroupchangeReason": null, "modifieddatecolor": null, "modifiedusercreatedDate": null "2018-08-03 14:39:38", "noPrefSelectedcreatedUser": null"JoeSchmo", "noShowReasondescription": null"Need a longer break!", "noteendDate": "2018-10-01", "packageSoldIdendTime": null"1400", "pricemodifiedDate": null"2018-08-07 11:34:56", "reasonmodifiedUser": {Reason object for service of appointment-see services API page}"JoeSchmo", "reasonGroupreason": {Reason group object for reason of grouptime ofoff appointment-- for more info, see groupsServices API page}, "recallrecurringAppointmentId": null, "recallDatestaff": null,{Staff object for staff "recallStatus": null, "recurringAppointmentId": 101096with time off - for more info, see Staff API page}, "remindClientSmsHrsstaffId": 280891, "remindStaffSmsHoursstartDate": 4"2018-10-01", "resourcestartTime": {Resource object for resource of appointment-see resources API page}"1100", "status": "1100", "seatstimeOffId": 1, "sendConfirmationToClient": false, "sendConfirmationToStaff": false, "staff": {Staff object for staff of appointment-see staff API page}, "staffReminderHours": 3, "staffRescheduleCount": 9, "startDate": "2018-07-26", "startTime": 945, "status": "OPEN", "subStatus": "CONFIRMED", "transactionFee": null, "waitlistId": null } |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"businessId": 43111,
"color":
"createdDate": "2018-08-03 14:39:38",
"createdUser": "JoeSchmo",
"description": "Need a break!",
"endDate": "2018-10-01",
"endTime": 1200,
"modifiedDate": "2018-08-07 15:10:27",
"modifiedUser": "JoeSchmo",
"reason": {Reason object for reason of time off-see services API page},
"recurringAppointmentId": null,
"staff": {Staff object for staff with time off-see staff API page},
"startDate": "2018-10-01",
"startTime": 1100,
"status": "Open",
"timeOffId": 17360947
} |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
[{
"additionalStaffIdList": null,
"address": null,
"appointmentDateTimeClient": "Thursday, Jul 26, 2018 at 12:00 PM FNT",
"appointmentDateTimeStaff": "Thursday, Jul 26, 2018 at 12:00 PM FNT",
"blockStaffIdList": [],
"blockedStaffList": [],
"businessId": 43111,
"calendarId": 17246703,
"cancelReason": "",
"cancelUser": "JoeSchmo",
"changeReason": "",
"classScheduleId": null,
"client": null,
"clientConfirmedDate": 1532371154462,
"clientConfirmed": false,
"clientEndDate": "2018-07-26",
"clientEndTime": 1330,
"clientReminderHours": 0,
"clientRescheduleCount": 0,
"clientStartDate": "2018-07-26",
"clientStartTime": 1200,
"color": null,
"completedReason": "",
"coordinatorStaff": {Staff object for coordinator staff of appointment-see staff API page},
"coupon": null,
"couponId": null,
"createddate": "2018-07-24 16:10:52",
"createduser": "JoeSchmo",
"customFieldDesc": "".
"date": "2018-07-26",
"dateCheckedIn": null,
"dateCompleted": 1530785153340,
"dateStarted": 1532525579100,
"discount": null,
"endDate": "2018-07-26",
"endTime": 1325,
"fields": {Scheduler field object for field of appointment-see scheduler fields API page},
"invitationUUId": null,
"jobRequisitionId": null,
"location": {Location object for location of appointment-see locations API page},
"locationGroup": {Location group object for location group of appointment-see groups API page},
"locationSuperGroup": null,
"modifieddate": null,
"modifieduser": null,
"noPrefSelected": null,
"noShowReason": "",
"note": "",
"packageSoldId": null,
"price": 8,
"reason": {Reason object for service of appointment-see services API page},
"reasonGroup": null,
"recall": null,
"recallDate": null,
"recallStatus": null,
"recurringAppointmentId": null,
"remindClientSmsHrs": 1,
"remindStaffSmsHours": 0,
"resource": {Resource object for resource of appointment-see resources API page},
"seats": 1,
"sendConfirmationToClient": false,
"sendConfirmationToStaff": false,
"staff": {Staff object for staff of appointment-see staff API page},
"staffReminderHours": 0,
"staffRescheduleCount": 6,
"startDate": "2018-07-26",
"startTime": 1115,
"status": "COMPLETED",
"subStatus": "INPROGRESS",
"transactionFee": null,
"waitlistId": null
}] |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"classScheduleId": null,
"client": {Client object for client of appointment-see clients API page},
"clientEndDate": "2018-07-26",
"clientEndTime": 1330,
"clientReminderHours": 0,
"clientStartDate": "2018-07-26",
"clientStartTime": 1200,
"coordinatorStaff": {Staff object for coordinator staff of appointment-see staff API page},
"duration": 90,
"endDate": "2018-07-26",
"endTime": 1325,
"fields": {Scheduler fields object for fields of fields of appointment-see scheduler fields API page},
"invalidDates": false,
"location": {Location object for location of appointment-see locations API page},
"locationGroup": {Location group object for location group of appointment-see groups API page},
"note": "",
"price": 8,
"reason": {Reason object for service of appointment-see services API page},
"reasonGroup": {Reason group object for reason group of appointment-see groups API page},
"remindClientSmsHours": 1,
"remindStaffSmsHours": 0,
"resource": {Resource object for resource of appointment-see resources API page},
"resourceId": 2556,
"sendConfirmationToClient": false,
"sendConfirmationToStaff": false,
"staff": {Staff object for staff of appointment-see staff API page},
"staffReminderHours": 0,
"startDate": "2018-07-26",
"status": "OPEN"
} |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"additionalStaffIdList": null,
"address": null,
"appointmentDateTimeClient": "Thursday, Aug 2, 2018 at 8:00 AM FNT",
"appointmentDateTimeStaff": "Thursday, Aug 2, 2018 at 8:00 AM FNT",
"blockStaffIdList": [],
"blockedStaffList": [],
"businessId": 43111,
"calendarId": 16902080,
"cancelReason": null,
"cancelUser": null,
"changeReason": "",
"classScheduleId": null,
"client": {Client object for client of appointment-see clients API page},
"clientConfirmedDate": 1532371154462,
"clientConfirmed": false,
"clientEndDate": "2018-08-02",
"clientEndTime": 900,
"clientReminderHours": 0,
"clientRescheduleCount": 0,
"clientStartDate": "2018-08-02",
"clientStartTime": 800,
"color": "#668CD9",
"completedReason": null,
"coordinatorStaff": null,
"coupon": null,
"couponId": null,
"createddate": "2018-06-21 14:45:52",
"createduser": "JoeSchmo",
"customFieldDesc": "",
"date": "2018-08-02",
"dateCheckedIn": null,
"dateCompleted": null,
"discount": null,
"endDate": "2018-08-02",
"endTime": 930,
"fields": {Scheduler fields object for fields of fields of appointment-see scheduler fields API page},
"invitationUUId": null,
"jobRequisitionId": null,
"location": {Location object for location of appointment-see locations API page},
"locationGroup": {Location group object for location group of appointment-see groups API page},
"locationSuperGroup": null,
"modifieddate": null,
"modifieduser": null,
"noPrefSelected": null,
"noShowReason": null,
"note": "",
"packageSoldId": null,
"price": null,
"reason": {Reason object for service of appointment-see services API page},
"reasonGroup": {Reason group object for reason group of appointment-see groups API page},
"recall": null,
"recallDate": null,
"recallStatus": null,
"recurringAppointmentId": 101096,
"remindClientSmsHrs": 2,
"remindStaffSmsHours": 4,
"resource": {Resource object for resource of appointment-see resources API page},
"seats": 1,
"sendConfirmationToClient": false,
"sendConfirmationToStaff": false,
"staff": {Staff object for staff of appointment-see staff API page},
"staffReminderHours": 3,
"staffRescheduleCount": 9,
"startDate": "2018-08-02",
"startTime": 945,
"status": "OPEN",
"subStatus": "CONFIRMED",
"transactionFee": null,
"waitlistId": null
} |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"additionalStaffIdList": null,
"address": null,
"appointmentDateTimeClient": "Thursday, Jul 26, 2018 at 12:00 PM FNT",
"appointmentDateTimeStaff": "Thursday, Jul 26, 2018 at 12:00 PM FNT",
"blockStaffIdList": [],
"blockedStaffList": [],
"businessId": 43111,
"calendarId": 1726703,
"cancelReason": null,
"cancelUser": null,
"changeReason": "",
"classScheduleId": null,
"client": {Client object for client of appointment-see clients API page},
"clientConfirmedDate": 1532478709843,
"clientConfirmed": false,
"clientEndDate": "2018-07-26",
"clientEndTime": 1330,
"clientReminderHours": 0,
"clientRescheduleCount": 0,
"clientStartDate": "2018-07-26",
"clientStartTime": 1200,
"color": null,
"completedReason": "",
"coordinatorStaff": {Staff object for coordinator staff of appointment-see staff API page},
"coupon": null,
"couponId": null,
"createddate": "2018-07-24 16:10:52",
"createduser": "JoeSchmo",
"customFieldDesc": "",
"date": "2018-07-26",
"dateCheckedIn": 1532525743459,
"dateCompleted": 1532526150687,
"dateStarted": 1532525579100,
"discount": null,
"endDate": "2018-07-26",
"endTime": 930,
"fields": {Scheduler fields object for fields of fields of appointment-see scheduler fields API page},
"invitationUUId": null,
"jobRequisitionId": null,
"location": {Location object for location of appointment-see locations API page},
"locationGroup": {Location group object for location group of appointment-see groups API page},
"locationSuperGroup": null,
"modifieddate": null,
"modifieduser": null,
"noPrefSelected": null,
"noShowReason": null,
"note": "",
"packageSoldId": null,
"price": null,
"reason": {Reason object for service of appointment-see services API page},
"reasonGroup": {Reason group object for reason group of appointment-see groups API page},
"recall": null,
"recallDate": null,
"recallStatus": null,
"recurringAppointmentId": 101096,
"remindClientSmsHrs": 2,
"remindStaffSmsHours": 4,
"resource": {Resource object for resource of appointment-see resources API page},
"seats": 1,
"sendConfirmationToClient": false,
"sendConfirmationToStaff": false,
"staff": {Staff object for staff of appointment-see staff API page},
"staffReminderHours": 3,
"staffRescheduleCount": 9,
"startDate": "2018-08-02",
"startTime": 945,
"status": "OPEN",
"subStatus": "CONFIRMED",
"transactionFee": null,
"waitlistId": null
} |
17360947
} |
- For the appointments report endpoint, please refer to the Appointments API page.
Property name | Type | Required | Writable | Description |
---|---|---|---|---|
businessId | integer | Yes | Provides unique numeric ID of the business offering specified time off. | |
changeReason | boolean | Indicates whether or not the reason of the specified time off has been changed. | ||
color | string | Yes | Displays any color chosen to override specified time off on the backoffice calendar. | |
createdDate | string | Displays as date specified time off was created as YYYY-MM-DD with time after. | ||
createdUser | string | Displays the username of user who created specified time off. | ||
description | string | Yes | Displays any description that was added to time off profile. | |
endDate | string | Yes | Yes | Provides the date that specified time off is set to end as YYYY-MM-DD. |
endTime | integer | Yes | Yes | Provides the time that specified time off ends displayed in military format. |
modifiedDate | string | Displays as date specified time off was last modified as YYYY-MM-DD with time after. | ||
modifiedUser | string | Displays the username of user who last modified specified time off. | ||
reason | object | Yes | Yes | Displays the reason object connected to specified time off - for more info, see Services API page. |
recurringAppointmentId | integer | If specified time off is part of a repeating time off series, then this provides unique numeric ID of that series. | ||
staff | object | Yes | Yes | Displays the staff object connected to specified time off - for more info, see Staff API page. |
startDate | string | Yes | Yes | Provides the date that specified time off is set to begin as YYYY-MM-DD. |
startTime | integer | Yes | Yes | Provides the time that specified time off is set to begin displayed in military format. |
status | string | Yes | Yes | Displays the status of time off. Possible values include Open, Closed, or Cancelled. |
timeOffId | integer | Yes, on PUT calls | Provides unique numeric ID of specified time off. |