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-12-06",
"ended_on": "2025-12-06",
"note": null,
"total_time": 360,
"total_working_days": 1,
"percentage": null,
"created_at": "2025-12-06T05:03:13.029+01:00",
"updated_at": "2025-12-06T05:03:13.029+01: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-12-06T05:03:13.000+01: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-12-06",
"ended_on": "2025-12-06",
"note": null,
"total_time": 360,
"total_working_days": 1,
"percentage": null,
"created_at": "2025-12-06T05:03:13.054+01:00",
"updated_at": "2025-12-06T05:03:13.054+01: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-12-06T05:03:13.000+01: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-12-06",
"ended_on": "2025-12-06",
"note": null,
"total_time": 360,
"total_working_days": 1,
"percentage": null,
"created_at": "2025-12-06T05:03:13.282+01:00",
"updated_at": "2025-12-06T05:03:13.282+01: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-12-06T05:03:13.000+01: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": "Dec 6, 2025",
"ended_on": "Dec 6, 2025",
"time": 360
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "19"
}
},
"person": {
"data": {
"type": "people",
"id": "187"
}
},
"approver": {
"data": {
"type": "people",
"id": "188"
}
},
"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-12-06",
"ended_on": "2025-12-06",
"note": null,
"total_time": 360,
"total_working_days": 1,
"percentage": null,
"created_at": "2025-12-06T05:03:17.416+01:00",
"updated_at": "2025-12-06T05:03:17.441+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:17.437+01: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-12-06T05:03:17.000+01: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": "Dec 6, 2025",
"ended_on": "Dec 6, 2025",
"time": 360
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "20"
}
},
"person": {
"data": {
"type": "people",
"id": "192"
}
},
"approver": {
"data": {
"type": "people",
"id": "193"
}
},
"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": "Dec 6, 2025",
"ended_on": "Dec 6, 2025",
"time": 360
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "21"
}
},
"person": {
"data": {
"type": "people",
"id": "197"
}
},
"approver": {
"data": {
"type": "people",
"id": "198"
}
},
"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 usable 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 06/12/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": "Dec 6, 2025",
"ended_on": "Dec 6, 2025",
"time": 360
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "22"
}
},
"person": {
"data": {
"type": "people",
"id": "202"
}
},
"approver": {
"data": {
"type": "people",
"id": "203"
}
},
"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-12-06",
"ended_on": "2025-12-06",
"note": null,
"total_time": 360,
"total_working_days": 1,
"percentage": null,
"created_at": "2025-12-06T05:03:19.200+01:00",
"updated_at": "2025-12-06T05:03:19.209+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:19.206+01: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-12-06T05:03:19.000+01: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": "Dec 6, 2025",
"ended_on": "Dec 6, 2025",
"time": 360
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "30"
}
},
"person": {
"data": {
"type": "people",
"id": "234"
}
},
"approver": {
"data": {
"type": "people",
"id": "234"
}
},
"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": "Dec 6, 2025",
"ended_on": "Dec 8, 2025",
"time": 360,
"total_time": null,
"percentage": null,
"booking_method_id": null
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "31"
}
},
"person": {
"data": {
"type": "people",
"id": "237"
}
},
"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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 1080,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-12-06T05:03:24.801+01:00",
"updated_at": "2025-12-06T05:03:24.801+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:24.800+01: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-12-06T05:03:24.000+01: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": "Dec 6, 2025",
"ended_on": "Dec 8, 2025",
"time": 360,
"total_time": null,
"percentage": null,
"booking_method_id": 1
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "32"
}
},
"person": {
"data": {
"type": "people",
"id": "243"
}
},
"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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 1080,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-12-06T05:03:25.635+01:00",
"updated_at": "2025-12-06T05:03:25.635+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:25.635+01: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-12-06T05:03:25.000+01: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": "Dec 6, 2025",
"ended_on": "Dec 12, 2025",
"time": 360,
"total_time": null,
"percentage": 100,
"booking_method_id": 2
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "33"
}
},
"person": {
"data": {
"type": "people",
"id": "249"
}
},
"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-12-06",
"ended_on": "2025-12-12",
"note": null,
"total_time": 3360,
"total_working_days": 7,
"percentage": 100,
"created_at": "2025-12-06T05:03:26.313+01:00",
"updated_at": "2025-12-06T05:03:26.313+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:26.312+01: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-12-06T05:03:26.000+01: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": "Dec 6, 2025",
"ended_on": "Dec 12, 2025",
"time": 360,
"total_time": null,
"percentage": 100,
"booking_method_id": 2
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "34"
}
},
"person": {
"data": {
"type": "people",
"id": "255"
}
},
"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-12-06",
"ended_on": "2025-12-12",
"note": null,
"total_time": 3060,
"total_working_days": 7,
"percentage": 100,
"created_at": "2025-12-06T05:03:27.086+01:00",
"updated_at": "2025-12-06T05:03:27.086+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:27.085+01: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-12-06T05:03:27.000+01: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": "Dec 6, 2025",
"ended_on": "Dec 12, 2025",
"time": 360,
"total_time": null,
"percentage": 100,
"booking_method_id": 2
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "35"
}
},
"person": {
"data": {
"type": "people",
"id": "261"
}
},
"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-12-06",
"ended_on": "2025-12-12",
"note": null,
"total_time": 2880,
"total_working_days": 7,
"percentage": 100,
"created_at": "2025-12-06T05:03:27.873+01:00",
"updated_at": "2025-12-06T05:03:27.873+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:27.872+01: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-12-06T05:03:27.000+01: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": "Dec 6, 2025",
"ended_on": "Dec 8, 2025",
"time": 360,
"total_time": 360,
"percentage": null,
"booking_method_id": 3
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "36"
}
},
"person": {
"data": {
"type": "people",
"id": "267"
}
},
"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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 360,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-12-06T05:03:28.554+01:00",
"updated_at": "2025-12-06T05:03:28.554+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:28.554+01: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-12-06T05:03:28.000+01: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": "Dec 6, 2025",
"ended_on": "Dec 8, 2025",
"time": 360,
"total_time": 10000,
"percentage": null,
"booking_method_id": 3
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "37"
}
},
"person": {
"data": {
"type": "people",
"id": "273"
}
},
"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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 10000,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-12-06T05:03:29.277+01:00",
"updated_at": "2025-12-06T05:03:29.277+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:29.276+01: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-12-06T05:03:29.000+01: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": "Dec 6, 2025",
"ended_on": "Dec 8, 2025",
"time": 360,
"total_time": null,
"percentage": null,
"booking_method_id": 1
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "38"
}
},
"person": {
"data": {
"type": "people",
"id": "280"
}
},
"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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 720,
"total_working_days": 2,
"percentage": null,
"created_at": "2025-12-06T05:03:30.247+01:00",
"updated_at": "2025-12-06T05:03:30.247+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:30.246+01: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-12-06T05:03:30.000+01: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": "Dec 6, 2025",
"ended_on": "Dec 8, 2025",
"time": 360,
"total_time": null,
"percentage": 100,
"booking_method_id": 2
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "39"
}
},
"person": {
"data": {
"type": "people",
"id": "287"
}
},
"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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 960,
"total_working_days": 2,
"percentage": 100,
"created_at": "2025-12-06T05:03:31.075+01:00",
"updated_at": "2025-12-06T05:03:31.075+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:31.074+01: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-12-06T05:03:31.000+01: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": "Dec 6, 2025",
"ended_on": "Dec 8, 2025",
"time": 360,
"total_time": 360,
"percentage": null,
"booking_method_id": 3
},
"relationships": {
"event": {
"data": {
"type": "events",
"id": "40"
}
},
"person": {
"data": {
"type": "people",
"id": "294"
}
},
"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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 360,
"total_working_days": 2,
"percentage": null,
"created_at": "2025-12-06T05:03:31.991+01:00",
"updated_at": "2025-12-06T05:03:31.991+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:31.990+01: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-12-06T05:03:31.000+01: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": "Dec 6, 2025",
"ended_on": "Dec 6, 2025",
"time": 480
},
"relationships": {
"person": {
"data": {
"type": "people",
"id": "378"
}
},
"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-12-06",
"ended_on": "2025-12-06",
"note": null,
"total_time": 0,
"total_working_days": 0,
"percentage": null,
"created_at": "2025-12-06T05:03:46.125+01:00",
"updated_at": "2025-12-06T05:03:46.125+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:46.125+01: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-12-06T05:03:46.000+01: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-12-06T05:03:50.624+01:00",
"ended_on": "2027-12-06T05:03:50.624+01:00",
"time": 100
},
"relationships": {
"service": {
"data": {
"type": "services",
"id": "47"
}
},
"person": {
"data": {
"type": "people",
"id": "404"
}
}
}
}
}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/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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 360,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-12-06T05:03:55.883+01:00",
"updated_at": "2025-12-06T05:03:55.950+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:55.865+01: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-12-06T05:03:55.000+01: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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 540,
"total_working_days": 3,
"percentage": 50,
"created_at": "2025-12-06T05:03:56.622+01:00",
"updated_at": "2025-12-06T05:03:56.719+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:56.604+01: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-12-06T05:03:56.000+01: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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 900,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-12-06T05:03:57.499+01:00",
"updated_at": "2025-12-06T05:03:57.577+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:57.499+01: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-12-06T05:03:57.000+01: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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 1440,
"total_working_days": 3,
"percentage": 100,
"created_at": "2025-12-06T05:03:58.283+01:00",
"updated_at": "2025-12-06T05:03:58.350+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:58.263+01: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-12-06T05:03:58.000+01: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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 504,
"total_working_days": 3,
"percentage": 35,
"created_at": "2025-12-06T05:03:59.161+01:00",
"updated_at": "2025-12-06T05:03:59.226+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:59.142+01: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-12-06T05:03:59.000+01: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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 900,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-12-06T05:03:59.898+01:00",
"updated_at": "2025-12-06T05:03:59.966+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:03:59.898+01: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-12-06T05:03:59.000+01: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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 735,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-12-06T05:04:00.800+01:00",
"updated_at": "2025-12-06T05:04:00.872+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:04:00.800+01: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-12-06T05:04:00.000+01: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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 720,
"total_working_days": 3,
"percentage": 50,
"created_at": "2025-12-06T05:04:01.567+01:00",
"updated_at": "2025-12-06T05:04:01.638+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:04:01.567+01: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-12-06T05:04:01.000+01: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": 484
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "71",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 0,
"total_working_days": 0,
"percentage": null,
"created_at": "2025-12-06T05:04:02.324+01:00",
"updated_at": "2025-12-06T05:04:02.412+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:04:02.324+01: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-12-06T05:04:02.000+01: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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 1080,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-12-06T05:04:03.204+01:00",
"updated_at": "2025-12-06T05:04:03.266+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:04:03.184+01: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-12-06T05:04:03.000+01: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-12-06",
"ended_on": "2025-12-08",
"note": null,
"total_time": 1080,
"total_working_days": 3,
"percentage": null,
"created_at": "2025-12-06T05:04:04.044+01:00",
"updated_at": "2025-12-06T05:04:04.106+01:00",
"people_custom_fields": null,
"approved": true,
"approved_at": "2025-12-06T05:04:04.024+01: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-12-06T05:04:04.000+01: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-12-06T05:04:04.919+01: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/76
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/81/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": "81",
"type": "bookings",
"attributes": {
"hours": 6,
"time": 360,
"started_on": "2025-12-06",
"ended_on": "2025-12-06",
"note": null,
"total_time": 360,
"total_working_days": 1,
"percentage": null,
"created_at": "2025-12-06T05:04:07.500+01:00",
"updated_at": "2025-12-06T05:04:07.520+01: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-12-06T05:04:07.000+01: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 06 Dec 2025