API Documentation
Bookings ¶
Bookings ¶
The Booking object represents a scheduled time allocation for a person, serving as a core component for tracking time, managing availability, and organizing resource allocation. There are two main types of bookings:
-
Budget bookings - where a person is allocated to work on a specific deal/budget. These bookings are linked to a service object, which represents the actual work being done.
-
Absence bookings - which track time off and remote work absences. These bookings are linked to an event object, representing the type of absence (time off or remote work).
Each booking method defines how time is allocated and requires specific attributes to be set: Per day (requires hours and time attributes to specify hours and time for each day), Percentage (requires percentage attribute to allocate a portion of a person’s available time) and Total hours (requires total_time attribute to specify the total amount of hours for the selected period).
Bookings can have different states depending on their type:
-
Budget bookings can be either Tentative (when there’s a possibility of the time allocation but it’s not yet confirmed, indicated by
draft: true) or Confirmed -
Absence bookings go through an approval workflow with the following states: Pending (waiting for approval), Approved, Rejected (with a reason), or Canceled (if cancelled after submitting for approval)
Bookings can also be customized with custom fields to store additional information about booking. Custom fields allow you to add custom attributes or any other metadata relevant to your booking workflow. For more details on how to work with custom fields please refer to Working with custom fields guide.
The following diagram shows bookings in our data hierarchy:
Supported attributes
-
person_id(integer) - ID of the person booking is assigned to -
service_id(integer) - ID of the service booking is linked to (for budget bookings) -
event_id(integer) - ID of the event booking is linked to (for absence bookings) -
started_on(date) - Start date of the booking -
ended_on(date) - End date of the booking -
time(integer) - Time allocation in minutes (for per day booking method) -
total_time(integer) - Total time allocation in minutes (for total hours booking method) -
percentage(integer) - Percentage of available time (for percentage booking method) -
booking_method_id(integer) - Method of booking allocation- 1 (Per day)
- 2 (Percentage)
- 3 (Total hours)
-
origin_id(integer) - ID of the initial (first) booking when other bookings are created through a repeat action -
draft(boolean) - Indicates if the booking is in tentative state -
note(text) - Additional notes about the booking -
rejected_reason(text) - Reason for rejection if booking was rejected -
approver_id(integer) - ID of the person who approved the booking -
autotracking(boolean) - Enables automatic time tracking for the booking -
custom_fields(json) - Custom field key (ID) - value pairs for the booking -
attachment_ids(array) - IDs of attachments linked to the booking
Supported filter params
-
id (integer) (array)
-
person_id (integer) (array)
-
approver_id (integer) (array)
-
event_id (integer) (array)
-
draft (boolean) - filter bookings by their tentative state (true for tentative bookings, false for confirmed)
-
with_draft (boolean) - when true, includes tentative bookings in the response
-
approved_at (date)
-
created_at (date)
-
updated_at (date)
-
rejected_at (date)
-
canceled_at (date)
-
last_activity_at (date)
-
origin_id (integer) (array)
-
company_id (integer) (array)
-
budget_id (integer) (array)
-
project_id (integer) (array)
-
tags (array)
-
after (date)
-
before (date)
-
started_on (date)
-
ended_on (date)
-
people_custom_fields (string)
-
note (string)
-
project_type (array)
-
person_type (1: user, 2: contact, 3: placeholder)
-
approval_status (array)
-
status (array) - alias for approval_status
-
billing_type_id (integer) (array) (Fixed: 1, Actuals: 2, None: 3)
-
autotracking (boolean)
-
booking_type (event, service) - where ‘event’ filters absence bookings and ‘service’ filters budget bookings
-
person_subsidiary_id (integer)
-
canceled (boolean)
Supported sort params
-
id (integer)
-
started_on (date)
-
last_activity_at (date)
-
draft (boolean)
GET /api/v2/bookings
Requests
GET /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": [
{
"id": "1",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-22",
"note": null,
"total_time": 360,
"total_working_days": 1,
"percentage": null,
"created_at": "2025-08-22T06:02:47.416+02:00",
"updated_at": "2025-08-22T06:02:47.416+02:00",
"people_custom_fields": null,
"approved": false,
"approved_at": null,
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:02:47.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "101"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
{
"id": "2",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-22",
"note": null,
"total_time": 360,
"total_working_days": 1,
"percentage": null,
"created_at": "2025-08-22T06:02:47.439+02:00",
"updated_at": "2025-08-22T06:02:47.439+02:00",
"people_custom_fields": null,
"approved": false,
"approved_at": null,
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:02:47.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "101"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
}
],
"links": {
"first": "http://api-test.productive.io/api/v2/bookings?page%5Bnumber%5D=1&page%5Bsize%5D=30",
"last": "http://api-test.productive.io/api/v2/bookings?page%5Bnumber%5D=1&page%5Bsize%5D=30"
},
"meta": {
"current_page": 1,
"total_pages": 1,
"total_count": 2,
"page_size": 30,
"max_page_size": 200
}
}Get bookingsGET/api/v2/bookings
GET /api/v2/bookings/1
Requests
GET /api/v2/bookings/3
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-22",
"note": null,
"total_time": 360,
"total_working_days": 1,
"percentage": null,
"created_at": "2025-08-22T06:02:47.700+02:00",
"updated_at": "2025-08-22T06:02:47.700+02:00",
"people_custom_fields": null,
"approved": false,
"approved_at": null,
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:02:47.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "102"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Requests
POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": null
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"status": "400",
"title": "Bad Request",
"source": {}
}
]
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 22, 2025",
"time": 360
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "23"
}
},
"person": {
"data": {
"type": "people",
"id": "215"
}
},
"approver": {
"data": {
"type": "people",
"id": "216"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "10",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-22",
"note": null,
"total_time": 360,
"total_working_days": 1,
"percentage": null,
"created_at": "2025-08-22T06:02:51.087+02:00",
"updated_at": "2025-08-22T06:02:51.112+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:02:51.109+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:02:51.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "107"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 22, 2025",
"time": 360
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "24"
}
},
"person": {
"data": {
"type": "people",
"id": "220"
}
},
"approver": {
"data": {
"type": "people",
"id": "221"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "has no entitlements for this person",
"source": {
"pointer": "data/attributes/event"
}
}
]
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 22, 2025",
"time": 360
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "25"
}
},
"person": {
"data": {
"type": "people",
"id": "225"
}
},
"approver": {
"data": {
"type": "people",
"id": "226"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "no useable event entitlements",
"source": {
"pointer": "data/attributes/event"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "no bookable dates in range",
"source": {
"pointer": "data/attributes/event"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "missing entitlement for 22/08/2025",
"source": {
"pointer": "data/attributes/event"
}
}
]
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 22, 2025",
"time": 360
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "26"
}
},
"person": {
"data": {
"type": "people",
"id": "230"
}
},
"approver": {
"data": {
"type": "people",
"id": "231"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "11",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-22",
"note": null,
"total_time": 360,
"total_working_days": 1,
"percentage": null,
"created_at": "2025-08-22T06:02:52.671+02:00",
"updated_at": "2025-08-22T06:02:52.680+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:02:52.677+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:02:52.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "110"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"time": ""
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/person"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/started_on"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "is not a date",
"source": {
"pointer": "data/attributes/started_on"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/ended_on"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "is not a date",
"source": {
"pointer": "data/attributes/ended_on"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "is not a number",
"source": {
"pointer": "data/attributes/time"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/time"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "service and event can't be blank simultaneously",
"source": {
"pointer": "data/attributes/base"
}
}
]
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 22, 2025",
"time": 360
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "33"
}
},
"person": {
"data": {
"type": "people",
"id": "257"
}
},
"approver": {
"data": {
"type": "people",
"id": "255"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "17",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-22",
"note": null,
"total_time": 360,
"total_working_days": 1,
"percentage": null,
"created_at": "2025-08-22T06:02:56.259+02:00",
"updated_at": "2025-08-22T06:02:56.292+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:02:56.289+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:02:56.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "115"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 22, 2025",
"time": 360
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "34"
}
},
"person": {
"data": {
"type": "people",
"id": "262"
}
},
"approver": {
"data": {
"type": "people",
"id": "262"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"status": "403",
"code": "no_person",
"title": "Access Denied",
"detail": "User provided with X-Auth-Token header does not have a person associated in the organization provided with X-Organization-Id header",
"source": {}
}
]
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 24, 2025",
"time": 360,
"total_time": null,
"percentage": null,
"booking_method_id": null
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "35"
}
},
"person": {
"data": {
"type": "people",
"id": "265"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "18",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 1080,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-08-22T06:02:57.468+02:00",
"updated_at": "2025-08-22T06:02:57.468+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:02:57.468+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:02:57.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "117"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 24, 2025",
"time": 360,
"total_time": null,
"percentage": null,
"booking_method_id": 1
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "36"
}
},
"person": {
"data": {
"type": "people",
"id": "271"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "19",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 1080,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-08-22T06:02:58.031+02:00",
"updated_at": "2025-08-22T06:02:58.031+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:02:58.031+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:02:58.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "118"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 28, 2025",
"time": 360,
"total_time": null,
"percentage": 100,
"booking_method_id": 2
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "37"
}
},
"person": {
"data": {
"type": "people",
"id": "277"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "20",
"type": "bookings",
"attributes": {
"hours": null,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-28",
"note": null,
"total_time": 3360,
"total_working_days": 7,
"percentage": 100,
"created_at": "2025-08-22T06:02:58.588+02:00",
"updated_at": "2025-08-22T06:02:58.588+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:02:58.588+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 2,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:02:58.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "119"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 28, 2025",
"time": 360,
"total_time": null,
"percentage": 100,
"booking_method_id": 2
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "38"
}
},
"person": {
"data": {
"type": "people",
"id": "283"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "21",
"type": "bookings",
"attributes": {
"hours": null,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-28",
"note": null,
"total_time": 3060,
"total_working_days": 7,
"percentage": 100,
"created_at": "2025-08-22T06:02:59.313+02:00",
"updated_at": "2025-08-22T06:02:59.313+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:02:59.312+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 2,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:02:59.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "120"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 28, 2025",
"time": 360,
"total_time": null,
"percentage": 100,
"booking_method_id": 2
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "39"
}
},
"person": {
"data": {
"type": "people",
"id": "289"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "22",
"type": "bookings",
"attributes": {
"hours": null,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-28",
"note": null,
"total_time": 2880,
"total_working_days": 7,
"percentage": 100,
"created_at": "2025-08-22T06:03:00.057+02:00",
"updated_at": "2025-08-22T06:03:00.057+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:00.056+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 2,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:00.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "121"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 24, 2025",
"time": 360,
"total_time": 360,
"percentage": null,
"booking_method_id": 3
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "40"
}
},
"person": {
"data": {
"type": "people",
"id": "295"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "23",
"type": "bookings",
"attributes": {
"hours": null,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 360,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-08-22T06:03:00.641+02:00",
"updated_at": "2025-08-22T06:03:00.641+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:00.640+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 3,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:00.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "122"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 24, 2025",
"time": 360,
"total_time": 10000,
"percentage": null,
"booking_method_id": 3
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "41"
}
},
"person": {
"data": {
"type": "people",
"id": "301"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "24",
"type": "bookings",
"attributes": {
"hours": null,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 10000,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-08-22T06:03:01.432+02:00",
"updated_at": "2025-08-22T06:03:01.432+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:01.431+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 3,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:01.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "123"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 24, 2025",
"time": 360,
"total_time": null,
"percentage": null,
"booking_method_id": 1
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "42"
}
},
"person": {
"data": {
"type": "people",
"id": "308"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "25",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 720,
"total_working_days": 2,
"percentage": null,
"created_at": "2025-08-22T06:03:02.193+02:00",
"updated_at": "2025-08-22T06:03:02.193+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:02.192+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:02.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "124"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 24, 2025",
"time": 360,
"total_time": null,
"percentage": 100,
"booking_method_id": 2
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "43"
}
},
"person": {
"data": {
"type": "people",
"id": "315"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "26",
"type": "bookings",
"attributes": {
"hours": null,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 960,
"total_working_days": 2,
"percentage": 100,
"created_at": "2025-08-22T06:03:02.996+02:00",
"updated_at": "2025-08-22T06:03:02.996+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:02.995+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 2,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:02.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "125"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "Aug 22, 2025",
"ended_on": "Aug 24, 2025",
"time": 360,
"total_time": 360,
"percentage": null,
"booking_method_id": 3
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "44"
}
},
"person": {
"data": {
"type": "people",
"id": "322"
}
},
"origin": {
"data": {
"type": "bookings",
"id": ""
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "27",
"type": "bookings",
"attributes": {
"hours": null,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 360,
"total_working_days": 2,
"percentage": null,
"created_at": "2025-08-22T06:03:03.806+02:00",
"updated_at": "2025-08-22T06:03:03.806+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:03.805+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 3,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:03.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "126"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"time": ""
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/person"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/started_on"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "is not a date",
"source": {
"pointer": "data/attributes/started_on"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/ended_on"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "is not a date",
"source": {
"pointer": "data/attributes/ended_on"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "is not a number",
"source": {
"pointer": "data/attributes/time"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/time"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "service and event can't be blank simultaneously",
"source": {
"pointer": "data/attributes/base"
}
}
]
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"booking_method_id": "1",
"started_on": "Aug 22, 2025",
"ended_on": "Aug 22, 2025",
"time": 480
},
"relationships": {
"person": {
"data": {
"type": "people",
"id": "406"
}
},
"service": {
"data": {
"type": "services",
"id": "41"
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "50",
"type": "bookings",
"attributes": {
"hours": 8,
"time": 480,
"started_on": "2025-08-22",
"ended_on": "2025-08-22",
"note": null,
"total_time": 480,
"total_working_days": 1,
"percentage": null,
"created_at": "2025-08-22T06:03:15.994+02:00",
"updated_at": "2025-08-22T06:03:15.994+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:15.994+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:15.000+02:00",
"stage_type": 2
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "141"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/bookings
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"started_on": "2023-08-22T06:03:19.984+02:00",
"ended_on": "2027-08-22T06:03:19.984+02:00",
"time": 100
},
"relationships": {
"service": {
"data": {
"type": "services",
"id": "47"
}
},
"person": {
"data": {
"type": "people",
"id": "432"
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "must be less than or equal to 2 years",
"source": {
"pointer": "data/attributes/date_range"
}
}
]
}Create a bookingPOST/api/v2/bookings
URI Parameters
- person_id
number(required) Example: 1person id
- started_on
date(required) Example: 2018-01-01started on
- ended_on
date(required) Example: 2018-01-31ended on
- time
number(required) Example: 60time
- booking_method_id
number(required) Example: 21: hours per day, time attribute needs to be set; 2: percentage per day, percentage attribute needs to be set; 3: total time
- event_id
number(optional) Example: 1Required if you are making a Timeoff/Event booking
- service_id
number(optional) Example: 1Required if you are making a Service booking
- note
string(optional) Example: some+notebooking note
- percentage
number(optional) Example: 100percentage of working hours, must be set to 50 or 100, required with booking_method_id 2
PATCH /api/v2/bookings/1
Requests
PATCH /api/v2/bookings/61
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"time": 120
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "61",
"type": "bookings",
"attributes": {
"hours": 2,
"time": 120,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 360,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-08-22T06:03:23.157+02:00",
"updated_at": "2025-08-22T06:03:23.237+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:23.153+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:23.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "151"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/bookings/62
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"time": ""
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "is not a number",
"source": {
"pointer": "data/attributes/time"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/time"
}
}
]
}PATCH /api/v2/bookings/63
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"time": 120,
"booking_method_id": 1
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "63",
"type": "bookings",
"attributes": {
"hours": 2,
"time": 120,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 360,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-08-22T06:03:24.268+02:00",
"updated_at": "2025-08-22T06:03:24.345+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:24.246+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:24.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "153"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/bookings/64
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"percentage": 50,
"booking_method_id": 2
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "64",
"type": "bookings",
"attributes": {
"hours": null,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 540,
"total_working_days": 3,
"percentage": 50,
"created_at": "2025-08-22T06:03:25.141+02:00",
"updated_at": "2025-08-22T06:03:25.251+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:25.120+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 2,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:25.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "154"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/bookings/65
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"total_time": 900,
"booking_method_id": 3
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "65",
"type": "bookings",
"attributes": {
"hours": null,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 900,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-08-22T06:03:26.019+02:00",
"updated_at": "2025-08-22T06:03:26.088+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:26.019+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 3,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:26.000+02:00",
"stage_type": 2
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "155"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/bookings/66
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"percentage": 100,
"booking_method_id": 2
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "66",
"type": "bookings",
"attributes": {
"hours": null,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 1440,
"total_working_days": 3,
"percentage": 100,
"created_at": "2025-08-22T06:03:26.902+02:00",
"updated_at": "2025-08-22T06:03:26.977+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:26.880+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 2,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:26.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "156"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/bookings/67
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"percentage": 35,
"booking_method_id": 2
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "67",
"type": "bookings",
"attributes": {
"hours": null,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 504,
"total_working_days": 3,
"percentage": 35,
"created_at": "2025-08-22T06:03:27.766+02:00",
"updated_at": "2025-08-22T06:03:27.839+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:27.744+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 2,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:27.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "157"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/bookings/68
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"total_time": 900,
"booking_method_id": 3
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "68",
"type": "bookings",
"attributes": {
"hours": null,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 900,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-08-22T06:03:28.766+02:00",
"updated_at": "2025-08-22T06:03:28.834+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:28.766+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 3,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:28.000+02:00",
"stage_type": 2
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "158"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/bookings/69
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"time": 245,
"booking_method_id": 1
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "69",
"type": "bookings",
"attributes": {
"hours": 4,
"time": 245,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 735,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-08-22T06:03:29.632+02:00",
"updated_at": "2025-08-22T06:03:29.700+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:29.632+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:29.000+02:00",
"stage_type": 2
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "159"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/bookings/70
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"percentage": 50,
"booking_method_id": 2
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "70",
"type": "bookings",
"attributes": {
"hours": null,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 720,
"total_working_days": 3,
"percentage": 50,
"created_at": "2025-08-22T06:03:30.498+02:00",
"updated_at": "2025-08-22T06:03:30.569+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:30.498+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 2,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:30.000+02:00",
"stage_type": 2
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "160"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/bookings/71
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"person_id": 512
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "71",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 0,
"total_working_days": 0,
"percentage": null,
"created_at": "2025-08-22T06:03:31.382+02:00",
"updated_at": "2025-08-22T06:03:31.476+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:31.382+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:31.000+02:00",
"stage_type": 2
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "161"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/bookings/72
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"draft": false
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "72",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 1080,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-08-22T06:03:32.404+02:00",
"updated_at": "2025-08-22T06:03:32.474+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:32.378+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:32.000+02:00",
"stage_type": 1
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "162"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/bookings/73
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"draft": true
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "73",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-24",
"note": null,
"total_time": 1080,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-08-22T06:03:33.486+02:00",
"updated_at": "2025-08-22T06:03:33.564+02:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-08-22T06:03:33.463+02:00",
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": true,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:33.000+02:00",
"stage_type": 1
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "163"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/bookings/74
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "bookings",
"attributes": {
"ended_on": "2028-08-22T06:03:34.508+02:00"
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "must be less than or equal to 2 years",
"source": {
"pointer": "data/attributes/date_range"
}
}
]
}DELETE /api/v2/bookings/1
Requests
DELETE /api/v2/bookings/75
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonResponses
This response has no content.
PATCH /api/v2/bookings/1/unapprove
Requests
PATCH /api/v2/bookings/80/unapprove
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "80",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-08-22",
"ended_on": "2025-08-22",
"note": null,
"total_time": 360,
"total_working_days": 1,
"percentage": null,
"created_at": "2025-08-22T06:03:36.698+02:00",
"updated_at": "2025-08-22T06:03:36.719+02:00",
"people_custom_fields": null,
"approved": false,
"approved_at": null,
"rejected": false,
"rejected_reason": null,
"rejected_at": null,
"canceled": false,
"canceled_at": null,
"booking_method_id": 1,
"autotracking": false,
"draft": false,
"custom_fields": null,
"external_id": null,
"last_activity_at": "2025-08-22T06:03:36.000+02:00",
"stage_type": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "170"
}
},
"service": {
"meta": {
"included": false
}
},
"event": {
"meta": {
"included": false
}
},
"person": {
"meta": {
"included": false
}
},
"creator": {
"meta": {
"included": false
}
},
"updater": {
"meta": {
"included": false
}
},
"approver": {
"meta": {
"included": false
}
},
"rejecter": {
"meta": {
"included": false
}
},
"canceler": {
"meta": {
"included": false
}
},
"origin": {
"meta": {
"included": false
}
},
"approval_statuses": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}Unapproves a bookingPATCH/api/v2/bookings/{id}/unapprove
URI Parameters
- id
number(required) Example: 1booking id
Generated by aglio on 22 Aug 2025