Agendize Resellers API

Appointments


Resource representation

{ "id": {string}, "reference": {string}, "company": { "id": {string}, "name": {string} }, "service": { "id": {string}, "name": {string} }, "resource": { "id": {string}, "name": {string} }, "staff": { "id": {string}, "firstName": {string}, "lastName": {string} }, "client": { "id": {string}, "firstName": {string}, "lastName": {string}, "email": {string}, "externalId": {string}, "timeZone": {string} }, "parent": { "id": {string}, "firstName": {string}, "lastName": {string}, "email": {string}, "externalId": {string}, "timeZone": {string} }, "start": { "dateTime": {datetime}, "timeZone": {string} }, "end": { "dateTime": {datetime}, "timeZone": {string} }, "created": { "dateTime": {datetime}, "timeZone": {string} }, "form": [ { "id": {string}, "title": {string}, "value": {string}, } ], "status": {string}, "notes": {string}, "history": [ { "text": {string}, "date": { "dateTime": {datetime}, "timeZone": {string} }, "user": { "firstName": {string}, "lastName": {string), "email": {string}, "userName": {string} } } ], "type": {string}, "paid": {boolean}, "addToWaitingList": {boolean}, "location": {string}, "locationCustom": {string} }
Parameter name Value Description Notes
id string Identifier of the appointment.
reference string Rerefence code of the appointment.
company object company details.
company.id string Identifier of the company.
company.name string Name of the company.
service object Service details. Only if the appointment is for a service.
service.id string Identifier of the service. writable
service.name string Name of the service.
resource object Resource details. Only if the appointment is for a resource.
resource.id string Identifier of the resource. writable
resource.name string Name of the resource.
staff object Staff details.
staff.id string Identifier of the company's staff member. writable
staff.firstName string First name of the company's staff member.
staff.lastName string Last name of the company's staff member.
client object Client details.
client.id string Identifier of the client. the id is unique and should not be reused for another account. writable
client.firstName string First name of the client. writable
client.lastName string Last name of the client. writable
client.email string Email Address of the client. writable
client.timeZone string Time zone of the client. Only if time zone has been specified. writable
client.externalId string Unique client identifier from another (external) system. writable
parent object For an appointment for someone else, details of the client who take the appointment.
parent.id string Identifier of the parent. the id is unique and should not be reused for another account. writable
parent.firstName string First name of the parent. writable
parent.lastName string Last name of the parent. writable
parent.email string Email Address of the parent. writable
parent.externalId string Unique parent identifier from another (external) system. writable
parent.timeZone string Time zone of the parent. Only if time zone has been specified. writable
start object The start time of the event. writable
start.dateTime string The time, as a combined date-time value (formatted according to RFC 3339, without time zone information). writable
start.timeZone string The time zone. Possible values can be found here. The default value is the time zone of the company. writable
end object The end time of the event. writable
end.dateTime string The time, as a combined date-time value (formatted according to RFC 3339, without time zone information). writable
end.timeZone string The time zone. Possible values can be found here. The default value is the time zone of the company. writable
created object Creation time of the event. Read-only.
form object The filled form of the event. writable
form[].id string Identifier of the field
form[].title string Title of the field
form[].value string Value of the field. For get and list methods and a file field type it is the link to the file. For insert and update methods it is the data URI scheme binary content of the file. writable
status string The status of the event. Values: "completed", "noShow", "accepted", "pending", "declined", "cancelled", "inProgress". writable
notes string Notes of the appointment. writable
type string The type of the event. Values: "normal" (appointment with a client) or "personal" (personal appointment). writable
paid string "true" if the appointment has been paid. writable
addToWaitingList string If "true", add the client to the waiting list. writable
location string Localization of the appointment. Values: "companyAddress", "videoconference", "phone", "custom". Default: "companyAddress". writable
locationCustom string Custom localization of the appointment. Read only

Get

Return a specific appointment belonging to one of all companies of resellers's account.

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

GET https://api.agendize.com/api/2.0/resellers/scheduling/appointments/{appointmentId}

Parameters

Parameter name Value Description
Path parameters
appointmentId string Appointment identifier or appointment reference.
Optional query parameters
lang string Language use to retreive appointment history strings.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns an Appointment resource in the response body.


List

Returns appointment entries on all companies of resellers's account.

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

GET https://api.agendize.com/api/2.0/resellers/scheduling/appointments

Parameters

Parameter name Value Description
Optional query parameters
startDate datetime Upper bound (exclusive) for an appointment's start time (as a RFC 3339 timestamp) in GMT to filter by. Optional. The default value is now -1 month.
endDate datetime Lower bound (exclusive) for an appointment's end time (as a RFC 3339 timestamp) in GMT to filter by. Optional. The default value is now +1 month.
createdStartDate datetime Upper bound (exclusive) for an appointment's creation time (as a RFC 3339 timestamp) in GMT to filter by. Optional. The default is not to filter by creation time.
createdEndDate datetime Lower bound (exclusive) for an appointment's creation time (as a RFC 3339 timestamp) in GMT to filter by. Optional. The default is not to filter by creation time.
clientExternalId string Unique client identifier from another (external) system.
showDeleted boolean Whether to include deleted appointment list entries in the result. Optional. The default is false.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a list of Appointment resource in the response body.