Booking Data Explained
The following is a list of data fields returned by the ACE360 Connect GET bookings
endpoint. We've written this reference guide to help you better understand the data you receive from Connect.
Contents
- id
- status
- bookingType
- bookingDate
- startTime
- endTime
- streetAddress
- city
- postcode
- meetingLink
- epas
- apprentices
- equipmentRequired
- dressCode
- ppe
- additionalNotes
- epaoInvigilatorRequired
- cancellationReason
- cancellationRequestReason
- availabilityInformation
- attendanceRecordedAt
- createdAt
id
Example:
"id": 1
This is the ACE360 internal ID for the booking.
status
Example:
"status": "confirmed"
Possible values: pending
, epao_action_required
, confirmed
, completed
, cancelled
, cancellation_requested
bookingType
Example:
"bookingType": "online"
Possible values: online
, in_person
bookingDate
Example:
"bookingDate": "2024-01-23"
startTime
Example:
"startTime": "09:00"
endTime
Example:
"endTime": "13:30"
streetAddress
Example:
"streetAddress": "1 Apple Street"
city
Example:
"city": "Big City"
postcode
Example:
"postcode": "AA1 1AA"
meetingLink
Example:
"meetingLink": "https://example-meeting-link"
This field can be used to store a meeting link (e.g. Teams, Zoom, etc) for online bookings.
epas
Example:
"epas": [
{
"id": 2933,
"typeId": 4
},
{
"id": 2934,
"typeId": 9
},
],
This is an array of the EPAs associated with the booking.
The id
and typeId
are internal ACE360 IDs. You will be able to use these IDs to query for more information when the releveant ACE360 Connect endpoints become available.
apprentices
Example:
"apprentices": [
{
"id": 245,
"attended": true
}
],
This array contains all of the apprentices that are associated with the booking. The apprentice id
can be used to look up more information about the apprentice.
Note that there are three possible values for the attended
field: true
, false
, and null
.
If the assessor has not yet recorded attendance for the booking, then then the attended
value will be null
for all apprentices on the booking.
equipmentRequired
Example:
"equipmentRequired": "A description of equipment required for the booking."
dressCode
Example:
"dressCode": "A description of the dress code required for the booking."
ppe
Example:
"ppe": "A description of the personal protective equipment required for the booking."
additionalNotes
Example:
"additionalNotes": "Any additional notes for the booking."
epaoInvigilatorRequired
Example:
"epaoInvigilatorRequired": true
cancellationReason
Example:
"cancellationReason": "A description of why the booking was cancelled."
cancellationRequestReason
Example:
"cancellationRequestReason": "A description of why a cancellation request was made."
availabilityInformation
Example:
"availabilityInformation": "Information relating to assessor availability."
attendanceRecordedAt
Example:
"attendanceRecordedAt": "2023-11-15 14:10:30"
This timestamp refers to the time that the assessor recorded the attendance in ACE360. Note that this may be some time after the booking has taken place.
createdAt
Example:
"createdAt": "2023-10-23 09:08:38"
This refers to the time that the booking was created in ACE360.