Skip to content

Booking

A booking.

Bookings are the core unit of work for carriers and locations. Bookings contain one or more tasks, which are the core unit of work for senders and receivers.

General 20
FieldTypeDescription
id*ID!The ID of the booking, The ID will always be in the format of "MDB-XX-XXXX-XXXX" where the first two XX after MDB are the last two digits of the year the booking was created in.
pinIDThe PIN code. Only a booking with a space has a PIN code. This code is guaranteed to be unique within 72 hours forward or backwards from the booking. Otherwise, no uniqueness is guaranteed.
requestedTime*Timestamp!The requested time of the booking.
bookedTimeTimestampThe booked time of the booking. Will not be present if the booking hasn't been approved.
duration*Int!The duration of the booking, in minutes.
actualLoad[ActualLoadQuantity!]The actual load of the booking. A location can set the actual load once the booking arrives.
tasks*[Task!]!A list of tasks on the booking.
comments*[Comment!]!A list of comments on the booking.
formResponses*[FormResponse!]!Form responses associated with the booking
driverDriverDriver linked to the current booking.
reassignedFromIDThe booking that this booking was reassigned from, if any.
reassignedToIDThe booking that this booking was reassigned to, if any.
userSubscriptionStatusBooleanThis flag indicates the notification subscription status of the user that is querying. A value of true indicates the user is subscribed. A value of false indicates the user has unsubscribed. A value of null indicates that there is no specific subscription status for this booking.
nextStatuses*[Status!]!Return the statuses that the given booking can move to, when updated by the given organisation. This does not count booking status overrides.
headerLoads*[LoadQuantity!]!A list of header loads defined for this booking
headerLoadsPlanned*[LoadQuantity!]!A list of planned header loads defined for this booking
tasksPlanned*[PlannedTask!]!A list of tasks initially planned before arrival. May differ from `tasks` if actuals were recorded during receipting.
subcarrierOrganisationReferenceSub carrier if exists
yardAssets*[YardAssetLink!]!Yard assets associated with the booking
updatableFields*[FieldCapturePoint!]!A list of field capture points from the Submitted status.
Carrier 2
FieldTypeDescription
carrier*OrganisationReference!The carrier for the booking.
carrierCoreCoreDetailsCore details for the booking's carrier.
Location 1
FieldTypeDescription
location*OrganisationReference!The location for the booking.
Area 1
FieldTypeDescription
areaAreaReferenceThe area of the booking. May be requested or actual, depending on the status of the booking. Null if the booking is submitted but no area has been provided.
Space 1
FieldTypeDescription
spaceSpaceReferenceThe space assigned to this booking. Will not be present if the booking hasn't been approved.
Vehicle 1
FieldTypeDescription
vehicle*VehicleReference!The vehicle on the booking.
Direction 1
FieldTypeDescription
direction*BookingDirection!The direction of the booking
Status 1
FieldTypeDescription
status*Status!The present status of the booking.
Booking 2
FieldTypeDescription
bookingHistory*[History!]!The history of a booking, ordered from earliest to latest.
bookingType*BookingType!The type of the booking.
Field 1
FieldTypeDescription
fields*[FieldData!]!Field data associated with the booking
Created 1
FieldTypeDescription
createdAt*Timestamp!The timestamp of booking creation (UTC)
Modified 1
FieldTypeDescription
modifiedAt*Timestamp!The timestamp of the last booking event (UTC).