Bookings
Booking records schedule and allocate a human resource to a project or task.
Available methods
-
GET
/bookings/
— Get the List of Bookings -
GET
/bookings/{id}
— Get a Booking
Booking object properties
A booking schedules and allocates a human resource to a project or task.
The Booking
object has the following properties:
Property |
Description |
Type |
Read-only |
Query allowed |
Sorting allowed |
---|---|---|---|---|---|
|
The approval status of the booking. Possible values:
|
string |
— |
Yes |
Yes |
|
A 1/0 field indicating whether the time booked is set as a percentage of schedule hours or as a number of hours.
|
Boolean |
— |
Yes |
Yes |
|
The attachments associated with this booking. Array of internal IDs for attachment objects. |
Array of {”id”: <integerValue>} objects. |
Yes |
— |
— |
|
The internal ID of the booking request associated with this booking. |
integer($int64) |
— |
Yes |
Yes |
|
The internal ID of the booking type associated with this booking. |
integer($int64) |
— |
Yes |
Yes |
|
The date the booking was created. |
string($date-time) |
Yes |
Yes |
— |
|
The internal ID of the customer associated with the booking. |
integer($int64) |
— |
Yes |
Yes |
|
The date the booking was approved. |
string($date) |
— |
Yes |
Yes |
|
The date the booking was rejected. |
string($date) |
— |
Yes |
Yes |
|
The date the booking was submitted. |
string($date) |
— |
Yes |
Yes |
|
The booking end date. |
string($date) |
— |
Yes |
Yes |
|
The booking end time. |
string |
— |
Yes |
Yes |
|
The unique external ID of the booking, if the record was imported from an external system. |
string |
— |
Yes |
Yes |
|
The number of hours for which the resource is booked to this task or project during the date range defined by |
number($float) |
Yes |
Yes |
Yes |
|
The internal ID of the job code associated with the booking. |
integer($int64) |
— |
Yes |
Yes |
|
The internal ID of the location associated with the booking. |
integer($int64) |
— |
Yes |
Yes |
|
The match score if this booking was created from search results. |
integer($int64) |
— |
Yes |
Yes |
|
Notes about this booking. |
string |
— |
Yes |
Yes |
|
A 1/0 field indicating whether to send notification email to the booking owner when the booking is modified. |
Boolean |
— |
Yes |
Yes |
|
The internal ID of the employee who created the booking. |
integer($int64) |
— |
Yes |
Yes |
|
The percentage of schedule hours for which the resource is booked to this task or project during the date range defined by |
number($float) |
— |
Yes |
Yes |
|
The preferred status of this booking (1-5). |
integer($int64) |
— |
Yes |
Yes |
|
The priority of this booking. |
integer($int64) |
— |
Yes |
Yes |
|
The internal ID of the project assignment profile associated with the booking. |
integer($int64) |
— |
Yes |
Yes |
|
The internal ID of the project associated with the booking. |
integer($int64) |
— |
Yes |
Yes |
|
The internal ID of the task associated with the booking. |
integer($int64) |
— |
Yes |
Yes |
|
The internal ID of the repeat event associated with the booking. |
integer($int64) |
— |
Yes |
Yes |
|
The internal ID of the resource request queue associated with the booking. |
integer($int64) |
— |
Yes |
Yes |
|
The internal ID of the first booking approver [ Other possible value:
|
integer($int64) |
— |
Yes |
Yes |
|
The internal ID of the first booking approver [ Other possible value:
|
integer($int64) |
— |
Yes |
Yes |
|
The internal ID of the first booking approver [ Other possible value:
|
integer($int64) |
— |
Yes |
Yes |
|
The internal ID of the schedule request item associated with the booking. |
integer($int64) |
— |
Yes |
Yes |
|
The internal ID of another booking that was used to create the booking. |
integer($int64) |
— |
Yes |
Yes |
|
The booking start date. |
string($date) |
— |
Yes |
Yes |
|
The booking start time. |
string |
— |
Yes |
Yes |
|
The date the booking was last updated or modified. |
string($date-time) |
Yes |
Yes |
— |
|
The internal ID of the employee associated with the booking — the resource booked. |
integer($int64) |
— |
Yes |
Yes |
Access to certain object types and object attributes depend on the business logic configured for your SuiteProjects Pro account. It may vary depending on the role and access privileges associated with the access token and with the user who authorized the application.
Required and read-only attributes also depend on the business logic configured for each specific SuiteProjects Pro account. Some fields such as id
, created
, and updated
are system-generated and always read-only.