BookingSync API documentation

Overview

Introduction Changelog Requirements Libraries Authorization Testing the Authorization Enumerables

Endpoints

Accounts Amenities Applications Availabilities Bathrooms Bedrooms Bookings Booking Comments Bookings Fees Bookings Payments Bookings Tags Bookings Taxes Change Overs Clients Contacts Destinations Fees Fees Taxes Hosts Inbox Attachments Inbox Conversations Inbox Messages Inbox Participants Inquiries Living Rooms LOS Records Mid Term Rate Maps Nightly Rate Maps Payment Gateways Payments Periods Photos Rates Rates Rules Rates Tables Rentals Rental Contacts Rental Agreements Rental Cancelation Policies Rental Cancelation Policy Items Rentals Amenities Rentals Contents Overrides Rentals Fees Rental Link Groups Rental Links Rentals Tags Rentals Taxes Rental URLs Reviews Seasons Sources Special Offers Taxes Tax Rules

Deprecated APIs

BookingSync API v1

Parameters

Name	Type	Read/Write	Description
id	Integer	Read	Booking’s id.
reference	String	Read	Booking’s reference code.
status	String	Read	Booking’s status.
updated_at	Time	Read	Booking’s update time.
start_at	Time	Read	Booking’s start time.
end_at	Time	Read	Booking’s end time.

Name	Type	Read/Write	Description
id	Integer	Read	Booking’s id.
client_id	Integer	Write	Client id related to the Booking.
source_id	Integer	Write	Source id related to the Booking.
bookings_tag_ids	Array	Write	Array of bookings_tags ids associated with Booking.
adults	Integer	Write	Booking’s number of adults.
booked	Boolean	Write	Booking’s booked status, false by default. When set to true, marks a regular booking.
channel_price	Integer	Write	Price accepted by the traveler on the channel site, excluding traveler’s fees (eg: Airbnb).
charge_damage_deposit_on_arrival	Boolean	Write	Defines if charge damage deposite will be charged on arrival.
children	Integer	Write	Booking’s number of children.
comission	Decimal	Write	Booking’s comission fee.
currency	String	Write	Booking’s currency code, list of codes described in enums section.
damage_deposit	Decimal	Write	Booking’s damage deposit.
discount	String	Write	Booking’s discount. (in percents e.g. 10%)
door_key_code	String	Write	Booking’s rental door key code.
downpayment	Decimal	Write	Booking’s downpayment.
expected_checkin_time	String	Write	Expected guest’s checkin time.
expected_checkout_time	String	Write	Expected guest’s checkout time.
final_payback_to_owner	Decimal	Write	Final payback to rental owner.
final_price	Decimal	Write	Booking’s final price. (after discount)
initial_price	Decimal	Write	Booking’s initial price.
payment_left_to_collect	Decimal	Read	Booking’s payment left to collect.
locked	String	Write	Booking’s locked status.
notes	Text	Write	Booking’s notes. (1000 characters max)
reference	String	Read	Booking’s reference code.
rental_payback_to_owner	Decimal	Write	Amount of money to pay back to owner (only rental, excluding fees).
status	String	Read	Booking’s status.
unavailable	Boolean	Write	Booking’s unavailable status, false by default. When set to true, marks the given period as unavailable. Commonly used for closed or maintenance periods.
external_reference	String	Read/Write	Booking’s reference from the source channel.
updated_at	Time	Read	Booking’s update time.
start_at	Time	Read/Write	Required. Booking’s start time.
end_at	Time	Read/Write	Required. Booking’s end time.
canceled_at	Time	Write	Booking’s cancel time.
tentative_expires_at	Time	Write	Booking’s tentative expiry time, null by default. When set, it will mark the period as “on hold” until the given date. Once this date is passed, the period will automatically become available again.
booked_at	Time	Write	Exact timestamp when a booking was booked

Name	Type	Read/Write	Description
id	Integer	Read	Booking’s id.
adults	Integer	Read	Booking’s number of adults.
booked	Boolean	Read	Booking’s booked status, false by default. When set to true, marks a regular booking.
bookings_payments_count	Integer	Read	Booking’s number of payments.
channel_price	Integer	Read	Price accepted by the traveler on the channel site, excluding traveler’s fees (eg: Airbnb).
charge_damage_deposit_on_arrival	Boolean	Read	Defines if charge damage deposite will be charged on arrival.
children	Integer	Read	Booking’s number of children.
comission	Decimal	Read	Booking’s comission fee.
currency	String	Read	Booking’s currency code, list of codes described in enums section.
damage_deposit	Decimal	Read	Booking’s damage deposit.
discount	String	Read	Booking’s discount. (in percents e.g. 10%)
door_key_code	String	Read	Booking’s rental door key code.
downpayment	Decimal	Read	Booking’s downpayment.
expected_checkin_time	String	Read	Expected guest’s checkin time.
expected_checkout_time	String	Read	Expected guest’s checkout time.
final_payback_to_owner	Decimal	Read	Final payback to rental owner.
final_price	Decimal	Read	Booking’s final price. (after discount)
final_rental_price	Decimal	Read	initial_rental_price reduced by discount (taxes and fees not included).
initial_price	Decimal	Read	Booking’s initial price.
initial_rental_price	Decimal	Read	An alias for initial_price
payment_left_to_collect	Decimal	Read	Booking’s payment left to collect.
locked	String	Read	Booking’s locked status.
notes	Text	Read	Booking’s notes.
owned_by_app	Boolean	Read	Defines whether booking was created by current app.
paid_amount	Decimal	Read	Booking’s amount that have already been paid.
payment_url	String	Read	Url for booking’s payment.
reference	String	Read	Booking’s reference code.
rental_payback_to_owner	Decimal	Read	Amount of money to pay back to owner (only rental, excluding fees).
review_requests_count	Integer	Read	Booking’s number of review requests.
status	String	Read	Booking’s status.
unavailable	Boolean	Read	Booking’s unavailable status, false by default. When set to true, marks the given period as unavailable. Commonly used for closed or maintenance periods.
external_reference	String	Read	Booking’s reference from the source channel.
balance_due_at	Time	Read	Booking’s payment deadline.
created_at	Time	Read	Booking’s create time.
updated_at	Time	Read	Booking’s update time.
start_at	Time	Read	Booking’s start time.
end_at	Time	Read	Booking’s end time.
canceled_at	Time	Read	Booking’s cancel time.
tentative_expires_at	Time	Read	Booking’s tentative expiry time, null by default. When set, it will mark the period as “on hold” until the given date. Once this date is passed, the period will automatically become available again.
contract_updated_at	Time	Read	Booking’s contract update time.

Name	Type	Read/Write	Description
id	Integer	Read	Booking’s id.
client_id	Integer	Write	Client id related to the Booking.
source_id	Integer	Write	Source id related to the Booking.
bookings_tag_ids	Array	Write	Array of bookings_tags ids associated with Booking.
adults	Integer	Read/Write	Booking’s number of adults.
booked	Boolean	Read/Write	Booking’s booked status, false by default. When set to true, marks a regular booking.
bookings_payments_count	Integer	Read	Booking’s number of payments.
channel_price	Integer	Read/Write	Price accepted by the traveler on the channel site, excluding traveler’s fees (eg: Airbnb).
charge_damage_deposit_on_arrival	Boolean	Read/Write	Defines if charge damage deposite will be charged on arrival.
children	Integer	Read/Write	Booking’s number of children.
comission	Decimal	Read/Write	Booking’s comission fee.
currency	String	Read/Write	Booking’s currency code, list of codes described in enums section.
damage_deposit	Decimal	Read/Write	Booking’s damage deposit.
discount	String	Read/Write	Booking’s discount. (in percents e.g. 10%)
door_key_code	String	Read/Write	Booking’s rental door key code.
downpayment	Decimal	Read/Write	Booking’s downpayment.
expected_checkin_time	String	Read/Write	Expected guest’s checkin time.
expected_checkout_time	String	Read/Write	Expected guest’s checkout time.
final_payback_to_owner	Decimal	Read/Write	Final payback to rental owner.
final_price	Decimal	Read/Write	Booking’s final price. (after discount)
final_rental_price	Decimal	Read	initial_rental_price reduced by discount (taxes and fees not included).
initial_price	Decimal	Read/Write	Booking’s initial price.
initial_rental_price	Decimal	Read	An alias for initial_price.
payment_left_to_collect	Decimal	Read	Booking’s payment left to collect.
locked	String	Read/Write	Booking’s locked status.
notes	Text	Read/Write	Booking’s notes. (1000 characters max)
owned_by_app	Boolean	Read	Defines whether booking was created by current app.
paid_amount	Decimal	Read	Booking’s amount that have already been paid.
payment_url	String	Read	Url for booking’s payment.
reference	String	Read	Booking’s reference code.
rental_payback_to_owner	Decimal	Read/Write	Amount of money to pay back to owner (only rental, excluding fees).
review_requests_count	Integer	Read	Booking’s number of review requests.
status	String	Read	Booking’s status.
unavailable	Boolean	Read/Write	Booking’s unavailable status, false by default. When set to true, marks the given period as unavailable. Commonly used for closed or maintenance periods.
external_reference	String	Read/Write	Booking’s reference from the source channel.
balance_due_at	Time	Read	Booking’s payment deadline.
created_at	Time	Read	Booking’s create time.
updated_at	Time	Read	Booking’s update time.
start_at	Time	Read/Write	Required. Booking’s start time.
end_at	Time	Read/Write	Required. Booking’s end time.
canceled_at	Time	Read/Write	Booking’s cancel time.
tentative_expires_at	Time	Read/Write	Booking’s tentative expiry time, null by default. When set, it will mark the period as “on hold” until the given date. Once this date is passed, the period will automatically become available again.
contract_updated_at	Time	Read	Booking’s contract update time.
booked_at	Time	Write	Exact timestamp when a booking was booked

List bookings

Based on the OAuth token scopes bookings listing will be limited to a certain range.

Scope	Read Permissions
`:public`	Display only future, not canceled bookings
`:bookings_write_owned`	Display only future, not canceled bookings
`:bookings_read`	Display all bookings
`:bookings_write`	Display all bookings

Returns a list of all bookings for current account(s).

Returns only future and non-canceled bookings by default

By default this endpoint returns only future and non-canceled bookings, if you like to change this behavior, make sure to check the search parameters.

GET /bookings

Response

{
  "links": {
    "bookings.account": "https://www.bookingsync.com/api/v3/accounts/{bookings.account}",
    "bookings.bookings_tags": "https://www.bookingsync.com/api/v3/bookings_tags/{bookings.bookings_tags}",
    "bookings.rental": "https://www.bookingsync.com/api/v3/rentals/{bookings.rental}",
    "bookings.rentals_tags": "https://www.bookingsync.com/api/v3/rentals_tags/{bookings.rentals_tags}"
  },
  "bookings": [
    {
      "id": 203,
      "status": "Booked",
      "updated_at": "2021-03-15T10:45:24Z",
      "start_at": "2021-03-22T10:45:24Z",
      "end_at": "2021-03-29T10:45:24Z",
      "links": {
        "account": 1,
        "bookings_tags": [
          1,
          2
        ],
        "rental": 16,
        "rentals_tags": [

        ]
      }
    }
  ],
  "meta": {
  }
}

{
  "links": {
    "bookings.account": "https://www.bookingsync.com/api/v3/accounts/{bookings.account}",
    "bookings.booking_comments": "https://www.bookingsync.com/api/v3/booking_comments/{bookings.booking_comments}",
    "bookings.bookings_fees": "https://www.bookingsync.com/api/v3/bookings_fees/{bookings.bookings_fees}",
    "bookings.bookings_payments": "https://www.bookingsync.com/api/v3/bookings_payments/{bookings.bookings_payments}",
    "bookings.bookings_tags": "https://www.bookingsync.com/api/v3/bookings_tags/{bookings.bookings_tags}",
    "bookings.bookings_taxes": "https://www.bookingsync.com/api/v3/bookings_taxes/{bookings.bookings_taxes}",
    "bookings.client": "https://www.bookingsync.com/api/v3/clients/{bookings.client}",
    "bookings.inquiry": "https://www.bookingsync.com/api/v3/inquiries/{bookings.inquiry}",
    "bookings.payments": "https://www.bookingsync.com/api/v3/payments/{bookings.payments}",
    "bookings.rental": "https://www.bookingsync.com/api/v3/rentals/{bookings.rental}",
    "bookings.rental_agreement": "https://www.bookingsync.com/api/v3/rental_agreements/{bookings.rental_agreement}",
    "bookings.rentals_tags": "https://www.bookingsync.com/api/v3/rentals_tags/{bookings.rentals_tags}",
    "bookings.source": "https://www.bookingsync.com/api/v3/sources/{bookings.source}"
  },
  "bookings": [
    {
      "id": 80,
      "adults": 5,
      "booked": true,
      "bookings_payments_count": 1,
      "channel_price": null,
      "charge_damage_deposit_on_arrival": true,
      "children": null,
      "commission": null,
      "currency": "USD",
      "damage_deposit": "0.0",
      "discount": "10%",
      "downpayment": null,
      "expected_checkin_time": "14:45",
      "expected_checkout_time": "11:30",
      "external_reference": null,
      "final_payback_to_owner": "0.0",
      "final_price": "2700.0",
      "final_rental_price": "2700.0",
      "initial_price": "3000.0",
      "initial_rental_price": "3000.0",
      "locked": null,
      "notes": "",
      "owned_by_app": false,
      "paid_amount": "2700.0",
      "payment_left_to_collect": "0.0",
      "payment_url": null,
      "reference": "0000EG",
      "rental_payback_to_owner": null,
      "review_requests_count": 0,
      "status": "Booked",
      "unavailable": false,
      "created_at": "2021-03-15T10:45:24Z",
      "updated_at": "2021-03-15T10:45:24Z",
      "start_at": "2021-03-22T10:45:24Z",
      "end_at": "2021-03-29T10:45:24Z",
      "canceled_at": null,
      "balance_due_at": "BALANCE_DUE_AT",
      "contract_updated_at": "CONTRACT_2021-03-15T10:45:24Z",
      "tentative_expires_at": null,
      "links": {
        "account": 1,
        "booking_comments": [

        ],
        "bookings_fees": [

        ],
        "bookings_payments": [
          23
        ],
        "bookings_tags": [
          1,
          2
        ],
        "bookings_taxes": [

        ],
        "client": 37,
        "inquiry": null,
        "payments": [
          23
        ],
        "rental": 16,
        "rental_agreement": null,
        "rentals_tags": [

        ],
        "source": null
      }
    }
  ],
  "meta": {
  }
}

Search bookings

Search parameters allow to filter bookings by specified fields.

Example:

GET /bookings?status=booked,unavailable&from=20140324

Search Parameters

Name	Type	Default	Description
from	Time	now	Bookings ending after given time. Default is now.
until	Time		Bookings starting before given time.
months	Integer		Bookings starting before `:from` + `:months`.
status	String		List of comma separated statuses. Possible values: booked,unavailable,tentative.
include_canceled	Boolean	false	Show also canceled bookings (requires `:bookings_read` or `:bookings_write` scope).
rental_id	String		List of comma separated IDs. Returns only bookings for this rental(s)
client_id	String		List of comma separated IDs. Returns only bookings for this client(s)
updated_since	Time		Bookings updated after given time. Also includes ids of bookings canceled after given time.

Get a single booking

Returns a single booking identified by ID

GET /bookings/:booking_id

Response

{
  "links": {
    "bookings.account": "https://www.bookingsync.com/api/v3/accounts/{bookings.account}",
    "bookings.bookings_tags": "https://www.bookingsync.com/api/v3/bookings_tags/{bookings.bookings_tags}",
    "bookings.rental": "https://www.bookingsync.com/api/v3/rentals/{bookings.rental}",
    "bookings.rentals_tags": "https://www.bookingsync.com/api/v3/rentals_tags/{bookings.rentals_tags}"
  },
  "bookings": [
    {
      "id": 203,
      "status": "Booked",
      "updated_at": "2021-03-15T10:45:24Z",
      "start_at": "2021-03-22T10:45:24Z",
      "end_at": "2021-03-29T10:45:24Z",
      "links": {
        "account": 1,
        "bookings_tags": [
          1,
          2
        ],
        "rental": 16,
        "rentals_tags": [

        ]
      }
    }
  ],
  "meta": {
  }
}

{
  "links": {
    "bookings.account": "https://www.bookingsync.com/api/v3/accounts/{bookings.account}",
    "bookings.booking_comments": "https://www.bookingsync.com/api/v3/booking_comments/{bookings.booking_comments}",
    "bookings.bookings_fees": "https://www.bookingsync.com/api/v3/bookings_fees/{bookings.bookings_fees}",
    "bookings.bookings_payments": "https://www.bookingsync.com/api/v3/bookings_payments/{bookings.bookings_payments}",
    "bookings.bookings_tags": "https://www.bookingsync.com/api/v3/bookings_tags/{bookings.bookings_tags}",
    "bookings.bookings_taxes": "https://www.bookingsync.com/api/v3/bookings_taxes/{bookings.bookings_taxes}",
    "bookings.client": "https://www.bookingsync.com/api/v3/clients/{bookings.client}",
    "bookings.inquiry": "https://www.bookingsync.com/api/v3/inquiries/{bookings.inquiry}",
    "bookings.payments": "https://www.bookingsync.com/api/v3/payments/{bookings.payments}",
    "bookings.rental": "https://www.bookingsync.com/api/v3/rentals/{bookings.rental}",
    "bookings.rental_agreement": "https://www.bookingsync.com/api/v3/rental_agreements/{bookings.rental_agreement}",
    "bookings.rentals_tags": "https://www.bookingsync.com/api/v3/rentals_tags/{bookings.rentals_tags}",
    "bookings.source": "https://www.bookingsync.com/api/v3/sources/{bookings.source}"
  },
  "bookings": [
    {
      "id": 80,
      "adults": 5,
      "booked": true,
      "bookings_payments_count": 1,
      "channel_price": null,
      "charge_damage_deposit_on_arrival": true,
      "children": null,
      "commission": null,
      "currency": "USD",
      "damage_deposit": "0.0",
      "discount": "10%",
      "downpayment": null,
      "expected_checkin_time": "14:45",
      "expected_checkout_time": "11:30",
      "external_reference": null,
      "final_payback_to_owner": "0.0",
      "final_price": "2700.0",
      "final_rental_price": "2700.0",
      "initial_price": "3000.0",
      "initial_rental_price": "3000.0",
      "locked": null,
      "notes": "",
      "owned_by_app": false,
      "paid_amount": "2700.0",
      "payment_left_to_collect": "0.0",
      "payment_url": null,
      "reference": "0000EG",
      "rental_payback_to_owner": null,
      "review_requests_count": 0,
      "status": "Booked",
      "unavailable": false,
      "created_at": "2021-03-15T10:45:24Z",
      "updated_at": "2021-03-15T10:45:24Z",
      "start_at": "2021-03-22T10:45:24Z",
      "end_at": "2021-03-29T10:45:24Z",
      "canceled_at": null,
      "balance_due_at": "BALANCE_DUE_AT",
      "contract_updated_at": "CONTRACT_2021-03-15T10:45:24Z",
      "tentative_expires_at": null,
      "links": {
        "account": 1,
        "booking_comments": [

        ],
        "bookings_fees": [

        ],
        "bookings_payments": [
          23
        ],
        "bookings_tags": [
          1,
          2
        ],
        "bookings_taxes": [

        ],
        "client": 37,
        "inquiry": null,
        "payments": [
          23
        ],
        "rental": 16,
        "rental_agreement": null,
        "rentals_tags": [

        ],
        "source": null
      }
    }
  ],
  "meta": {
  }
}

Create a new booking

Status assignment

To assign a status to a booking, you have to set either booked, unavailable or tentative_expires_at fields. Only one of those attributes can be used at the same time.

Creates a booking for given rental.

POST /rentals/:rental_id/bookings

Example JSON request

{
  "bookings": [
    {
      "adults": 5,
      "booked": true,
      "bookings_tag_ids": [
        1,
        2
      ],
      "client_id": 37,
      "currency": "USD",
      "discount": "10%",
      "final_price": "2700.0",
      "initial_price": "3000.0",
      "start_at": "2021-03-22T10:45:24Z",
      "end_at": "2021-03-29T10:45:24Z"
    }
  ]
}

Response

{
  "links": {
    "bookings.account": "https://www.bookingsync.com/api/v3/accounts/{bookings.account}",
    "bookings.booking_comments": "https://www.bookingsync.com/api/v3/booking_comments/{bookings.booking_comments}",
    "bookings.bookings_fees": "https://www.bookingsync.com/api/v3/bookings_fees/{bookings.bookings_fees}",
    "bookings.bookings_payments": "https://www.bookingsync.com/api/v3/bookings_payments/{bookings.bookings_payments}",
    "bookings.bookings_tags": "https://www.bookingsync.com/api/v3/bookings_tags/{bookings.bookings_tags}",
    "bookings.bookings_taxes": "https://www.bookingsync.com/api/v3/bookings_taxes/{bookings.bookings_taxes}",
    "bookings.client": "https://www.bookingsync.com/api/v3/clients/{bookings.client}",
    "bookings.inquiry": "https://www.bookingsync.com/api/v3/inquiries/{bookings.inquiry}",
    "bookings.payments": "https://www.bookingsync.com/api/v3/payments/{bookings.payments}",
    "bookings.rental": "https://www.bookingsync.com/api/v3/rentals/{bookings.rental}",
    "bookings.rental_agreement": "https://www.bookingsync.com/api/v3/rental_agreements/{bookings.rental_agreement}",
    "bookings.rentals_tags": "https://www.bookingsync.com/api/v3/rentals_tags/{bookings.rentals_tags}",
    "bookings.source": "https://www.bookingsync.com/api/v3/sources/{bookings.source}"
  },
  "bookings": [
    {
      "id": 80,
      "adults": 5,
      "booked": true,
      "bookings_payments_count": 1,
      "channel_price": null,
      "charge_damage_deposit_on_arrival": true,
      "children": null,
      "commission": null,
      "currency": "USD",
      "damage_deposit": "0.0",
      "discount": "10%",
      "downpayment": null,
      "expected_checkin_time": "14:45",
      "expected_checkout_time": "11:30",
      "external_reference": null,
      "final_payback_to_owner": "0.0",
      "final_price": "2700.0",
      "final_rental_price": "2700.0",
      "initial_price": "3000.0",
      "initial_rental_price": "3000.0",
      "locked": null,
      "notes": "",
      "owned_by_app": false,
      "paid_amount": "2700.0",
      "payment_left_to_collect": "0.0",
      "payment_url": null,
      "reference": "0000EG",
      "rental_payback_to_owner": null,
      "review_requests_count": 0,
      "status": "Booked",
      "unavailable": false,
      "created_at": "2021-03-15T10:45:24Z",
      "updated_at": "2021-03-15T10:45:24Z",
      "start_at": "2021-03-22T10:45:24Z",
      "end_at": "2021-03-29T10:45:24Z",
      "canceled_at": null,
      "balance_due_at": "BALANCE_DUE_AT",
      "contract_updated_at": "CONTRACT_2021-03-15T10:45:24Z",
      "tentative_expires_at": null,
      "links": {
        "account": 1,
        "booking_comments": [

        ],
        "bookings_fees": [

        ],
        "bookings_payments": [
          23
        ],
        "bookings_tags": [
          1,
          2
        ],
        "bookings_taxes": [

        ],
        "client": 37,
        "inquiry": null,
        "payments": [
          23
        ],
        "rental": 16,
        "rental_agreement": null,
        "rentals_tags": [

        ],
        "source": null
      }
    }
  ],
  "meta": {
  }
}

{
  "links": {
    "bookings.account": "https://www.bookingsync.com/api/v3/accounts/{bookings.account}",
    "bookings.booking_comments": "https://www.bookingsync.com/api/v3/booking_comments/{bookings.booking_comments}",
    "bookings.bookings_fees": "https://www.bookingsync.com/api/v3/bookings_fees/{bookings.bookings_fees}",
    "bookings.bookings_payments": "https://www.bookingsync.com/api/v3/bookings_payments/{bookings.bookings_payments}",
    "bookings.bookings_tags": "https://www.bookingsync.com/api/v3/bookings_tags/{bookings.bookings_tags}",
    "bookings.bookings_taxes": "https://www.bookingsync.com/api/v3/bookings_taxes/{bookings.bookings_taxes}",
    "bookings.client": "https://www.bookingsync.com/api/v3/clients/{bookings.client}",
    "bookings.inquiry": "https://www.bookingsync.com/api/v3/inquiries/{bookings.inquiry}",
    "bookings.payments": "https://www.bookingsync.com/api/v3/payments/{bookings.payments}",
    "bookings.rental": "https://www.bookingsync.com/api/v3/rentals/{bookings.rental}",
    "bookings.rental_agreement": "https://www.bookingsync.com/api/v3/rental_agreements/{bookings.rental_agreement}",
    "bookings.rentals_tags": "https://www.bookingsync.com/api/v3/rentals_tags/{bookings.rentals_tags}",
    "bookings.source": "https://www.bookingsync.com/api/v3/sources/{bookings.source}"
  },
  "bookings": [
    {
      "id": 80,
      "adults": 5,
      "booked": true,
      "bookings_payments_count": 1,
      "channel_price": null,
      "charge_damage_deposit_on_arrival": true,
      "children": null,
      "commission": null,
      "currency": "USD",
      "damage_deposit": "0.0",
      "discount": "10%",
      "downpayment": null,
      "expected_checkin_time": "14:45",
      "expected_checkout_time": "11:30",
      "external_reference": null,
      "final_payback_to_owner": "0.0",
      "final_price": "2700.0",
      "final_rental_price": "2700.0",
      "initial_price": "3000.0",
      "initial_rental_price": "3000.0",
      "locked": null,
      "notes": "",
      "owned_by_app": false,
      "paid_amount": "2700.0",
      "payment_left_to_collect": "0.0",
      "payment_url": null,
      "reference": "0000EG",
      "rental_payback_to_owner": null,
      "review_requests_count": 0,
      "status": "Booked",
      "unavailable": false,
      "created_at": "2021-03-15T10:45:24Z",
      "updated_at": "2021-03-15T10:45:24Z",
      "start_at": "2021-03-22T10:45:24Z",
      "end_at": "2021-03-29T10:45:24Z",
      "canceled_at": null,
      "balance_due_at": "BALANCE_DUE_AT",
      "contract_updated_at": "CONTRACT_2021-03-15T10:45:24Z",
      "tentative_expires_at": null,
      "links": {
        "account": 1,
        "booking_comments": [

        ],
        "bookings_fees": [

        ],
        "bookings_payments": [
          23
        ],
        "bookings_tags": [
          1,
          2
        ],
        "bookings_taxes": [

        ],
        "client": 37,
        "inquiry": null,
        "payments": [
          23
        ],
        "rental": 16,
        "rental_agreement": null,
        "rentals_tags": [

        ],
        "source": null
      }
    }
  ],
  "meta": {
  }
}

Comments, Fees and Taxes

You can also pass comments, bookings fees and bookings taxes directly during a booking creation using the parameters: comments, bookings_fees and bookings_taxes.

Example JSON request

{
  "bookings": [
    {
      "adults": 5,
      "booked": true,
      "bookings_fees": [
        {
          "price": "50",
          "times_booked": "2",
          "rentals_fee_id": "10",
          "name": "Fee1"
        },
        {
          "price": "30",
          "times_booked": "1",
          "rentals_fee_id": "10",
          "name": "Fee2"
        }
      ],
      "bookings_taxes": [
        {
          "taxable_type": "Rental",
          "taxable_id": "1",
          "amount": "60",
          "percentage": "10.0",
          "tax_id": "5",
          "included": false,
          "name": "Tax1"
        },
        {
          "taxable_type": "Rental",
          "taxable_id": "1",
          "amount": "40",
          "tax_id": "7",
          "included": false,
          "name": "Tax2"
        },
        {
          "taxable_type": "Rental",
          "taxable_id": "1",
          "amount": "10",
          "tax_id": "4",
          "included": true,
          "name": "Tax3"
        }
      ],
      "client_id": 37,
      "comments": [
        {
          "content": "Comment one"
        },
        {
          "content": "Comment two"
        }
      ],
      "currency": "USD",
      "discount": "10%",
      "final_price": "2930.0",
      "initial_price": "3000.0",
      "start_at": "2021-03-22T10:45:24Z",
      "end_at": "2021-03-29T10:45:24Z"
    }
  ]
}

Response

{
  "links": {
    "bookings.account": "https://www.bookingsync.com/api/v3/accounts/{bookings.account}",
    "bookings.booking_comments": "https://www.bookingsync.com/api/v3/booking_comments/{bookings.booking_comments}",
    "bookings.bookings_fees": "https://www.bookingsync.com/api/v3/bookings_fees/{bookings.bookings_fees}",
    "bookings.bookings_payments": "https://www.bookingsync.com/api/v3/bookings_payments/{bookings.bookings_payments}",
    "bookings.bookings_tags": "https://www.bookingsync.com/api/v3/bookings_tags/{bookings.bookings_tags}",
    "bookings.bookings_taxes": "https://www.bookingsync.com/api/v3/bookings_taxes/{bookings.bookings_taxes}",
    "bookings.client": "https://www.bookingsync.com/api/v3/clients/{bookings.client}",
    "bookings.inquiry": "https://www.bookingsync.com/api/v3/inquiries/{bookings.inquiry}",
    "bookings.payments": "https://www.bookingsync.com/api/v3/payments/{bookings.payments}",
    "bookings.rental": "https://www.bookingsync.com/api/v3/rentals/{bookings.rental}",
    "bookings.rental_agreement": "https://www.bookingsync.com/api/v3/rental_agreements/{bookings.rental_agreement}",
    "bookings.source": "https://www.bookingsync.com/api/v3/sources/{bookings.source}"
  },
  "bookings": [
    {
      "id": 80,
      "adults": 5,
      "booked": true,
      "bookings_fees": [
        {
          "links": {
            "account": 1,
            "booking": 80,
            "bookings_taxes": [

            ],
            "fee": 1,
            "rentals_fee": 10
          },
          "id": 10,
          "name": {
            "en": "Fee1"
          },
          "price": "50.0",
          "required": null,
          "included_in_price": true,
          "times_booked": 2,
          "created_at": "2017-08-10T09:36:10Z",
          "updated_at": "2017-08-10T09:36:10Z"
        },
        {
          "links": {
            "account": 1,
            "booking": 80,
            "bookings_taxes": [

            ],
            "fee": 1,
            "rentals_fee": 10
          },
          "id": 11,
          "name": {
            "en": "Fee2"
          },
          "price": "30.0",
          "required": null,
          "included_in_price": true,
          "times_booked": 1,
          "created_at": "2017-08-10T09:36:10Z",
          "updated_at": "2017-08-10T09:36:10Z"
        }
      ],
      "bookings_payments_count": 1,
      "bookings_taxes": [
        {
          "links": {
            "account": 1,
            "booking": 80,
            "tax": 5,
            "taxable": {
              "id": 1,
              "type": "Rental"
            }
          },
          "id": 22,
          "name": {
            "en": "Tax1"
          },
          "tax_included_in_price": false,
          "percentage": "10.0",
          "amount": "60.0"
        },
        {
          "links": {
            "account": 1,
            "booking": 80,
            "tax": 7,
            "taxable": {
              "id": 1,
              "type": "Rental"
            }
          },
          "id": 23,
          "name": {
            "en": "Tax2"
          },
          "tax_included_in_price": false,
          "percentage": "0.0",
          "amount": "40.0"
        },
        {
          "links": {
            "account": 1,
            "booking": 80,
            "tax": 4,
            "taxable": {
              "id": 1,
              "type": "Rental"
            }
          },
          "id": 24,
          "name": {
            "en": "Tax3"
          },
          "tax_included_in_price": true,
          "percentage": "0.0",
          "amount": "10.0"
        }
      ],
      "channel_price": null,
      "charge_damage_deposit_on_arrival": true,
      "children": null,
      "commission": null,
      "currency": "USD",
      "damage_deposit": "0.0",
      "discount": "10%",
      "downpayment": null,
      "expected_checkin_time": "14:45",
      "expected_checkout_time": "11:30",
      "external_reference": null,
      "final_payback_to_owner": "0.0",
      "final_price": "2700.0",
      "final_rental_price": "2700.0",
      "initial_price": "3000.0",
      "initial_rental_price": "3000.0",
      "locked": null,
      "notes": "",
      "owned_by_app": false,
      "paid_amount": "2700.0",
      "payment_url": null,
      "reference": "0000EG",
      "rental_payback_to_owner": null,
      "review_requests_count": 0,
      "status": "Booked",
      "unavailable": false,
      "created_at": "2021-03-15T10:45:24Z",
      "updated_at": "2021-03-15T10:45:24Z",
      "start_at": "2021-03-22T10:45:24Z",
      "end_at": "2021-03-29T10:45:24Z",
      "canceled_at": null,
      "balance_due_at": "BALANCE_DUE_AT",
      "contract_updated_at": "CONTRACT_2021-03-15T10:45:24Z",
      "tentative_expires_at": null,
      "links": {
        "account": 1,
        "booking_comments": [
          1,
          2
        ],
        "bookings_fees": [
          10,
          11
        ],
        "bookings_payments": [
          23
        ],
        "bookings_tags": [

        ],
        "bookings_taxes": [
          22,
          23,
          24
        ],
        "client": 37,
        "inquiry": null,
        "payments": [
          23
        ],
        "rental": 1,
        "rental_agreement": null,
        "source": null
      }
    }
  ],
  "meta": {
  }
}

{
  "links": {
    "bookings.account": "https://www.bookingsync.com/api/v3/accounts/{bookings.account}",
    "bookings.booking_comments": "https://www.bookingsync.com/api/v3/booking_comments/{bookings.booking_comments}",
    "bookings.bookings_fees": "https://www.bookingsync.com/api/v3/bookings_fees/{bookings.bookings_fees}",
    "bookings.bookings_payments": "https://www.bookingsync.com/api/v3/bookings_payments/{bookings.bookings_payments}",
    "bookings.bookings_tags": "https://www.bookingsync.com/api/v3/bookings_tags/{bookings.bookings_tags}",
    "bookings.bookings_taxes": "https://www.bookingsync.com/api/v3/bookings_taxes/{bookings.bookings_taxes}",
    "bookings.client": "https://www.bookingsync.com/api/v3/clients/{bookings.client}",
    "bookings.inquiry": "https://www.bookingsync.com/api/v3/inquiries/{bookings.inquiry}",
    "bookings.payments": "https://www.bookingsync.com/api/v3/payments/{bookings.payments}",
    "bookings.rental": "https://www.bookingsync.com/api/v3/rentals/{bookings.rental}",
    "bookings.rental_agreement": "https://www.bookingsync.com/api/v3/rental_agreements/{bookings.rental_agreement}",
    "bookings.source": "https://www.bookingsync.com/api/v3/sources/{bookings.source}"
  },
  "bookings": [
    {
      "id": 80,
      "adults": 5,
      "booked": true,
      "bookings_fees": [
        {
          "links": {
            "account": 1,
            "booking": 80,
            "bookings_taxes": [

            ],
            "fee": 1,
            "rentals_fee": 10
          },
          "id": 10,
          "name": {
            "en": "Fee1"
          },
          "price": "50.0",
          "required": null,
          "included_in_price": true,
          "times_booked": 2,
          "created_at": "2017-08-10T09:36:10Z",
          "updated_at": "2017-08-10T09:36:10Z"
        },
        {
          "links": {
            "account": 1,
            "booking": 80,
            "bookings_taxes": [

            ],
            "fee": 1,
            "rentals_fee": 10
          },
          "id": 11,
          "name": {
            "en": "Fee2"
          },
          "price": "30.0",
          "required": null,
          "included_in_price": true,
          "times_booked": 1,
          "created_at": "2017-08-10T09:36:10Z",
          "updated_at": "2017-08-10T09:36:10Z"
        }
      ],
      "bookings_payments_count": 1,
      "bookings_taxes": [
        {
          "links": {
            "account": 1,
            "booking": 80,
            "tax": 5,
            "taxable": {
              "id": 1,
              "type": "Rental"
            }
          },
          "id": 22,
          "name": {
            "en": "Tax1"
          },
          "tax_included_in_price": false,
          "percentage": "10.0",
          "amount": "60.0"
        },
        {
          "links": {
            "account": 1,
            "booking": 80,
            "tax": 7,
            "taxable": {
              "id": 1,
              "type": "Rental"
            }
          },
          "id": 23,
          "name": {
            "en": "Tax2"
          },
          "tax_included_in_price": false,
          "percentage": "0.0",
          "amount": "40.0"
        },
        {
          "links": {
            "account": 1,
            "booking": 80,
            "tax": 4,
            "taxable": {
              "id": 1,
              "type": "Rental"
            }
          },
          "id": 24,
          "name": {
            "en": "Tax3"
          },
          "tax_included_in_price": true,
          "percentage": "0.0",
          "amount": "10.0"
        }
      ],
      "channel_price": null,
      "charge_damage_deposit_on_arrival": true,
      "children": null,
      "commission": null,
      "currency": "USD",
      "damage_deposit": "0.0",
      "discount": "10%",
      "downpayment": null,
      "expected_checkin_time": "14:45",
      "expected_checkout_time": "11:30",
      "external_reference": null,
      "final_payback_to_owner": "0.0",
      "final_price": "2700.0",
      "final_rental_price": "2700.0",
      "initial_price": "3000.0",
      "initial_rental_price": "3000.0",
      "locked": null,
      "notes": "",
      "owned_by_app": false,
      "paid_amount": "2700.0",
      "payment_url": null,
      "reference": "0000EG",
      "rental_payback_to_owner": null,
      "review_requests_count": 0,
      "status": "Booked",
      "unavailable": false,
      "created_at": "2021-03-15T10:45:24Z",
      "updated_at": "2021-03-15T10:45:24Z",
      "start_at": "2021-03-22T10:45:24Z",
      "end_at": "2021-03-29T10:45:24Z",
      "canceled_at": null,
      "balance_due_at": "BALANCE_DUE_AT",
      "contract_updated_at": "CONTRACT_2021-03-15T10:45:24Z",
      "tentative_expires_at": null,
      "links": {
        "account": 1,
        "booking_comments": [
          1,
          2
        ],
        "bookings_fees": [
          10,
          11
        ],
        "bookings_payments": [
          23
        ],
        "bookings_tags": [

        ],
        "bookings_taxes": [
          22,
          23,
          24
        ],
        "client": 37,
        "inquiry": null,
        "payments": [
          23
        ],
        "rental": 1,
        "rental_agreement": null,
        "source": null
      }
    }
  ],
  "meta": {
  }
}

Update a booking

Returns an updated booking identified by ID.

PUT /bookings/:booking_id

Example JSON request

{
  "bookings": [
    {
      "adults": 5,
      "booked": true,
      "client_id": 37,
      "currency": "USD",
      "discount": "10%",
      "final_price": "2700.0",
      "initial_price": "3000.0",
      "start_at": "2021-03-22T10:45:24Z",
      "end_at": "2021-03-29T10:45:24Z"
    }
  ]
}

Response

{
  "links": {
    "bookings.account": "https://www.bookingsync.com/api/v3/accounts/{bookings.account}",
    "bookings.bookings_tags": "https://www.bookingsync.com/api/v3/bookings_tags/{bookings.bookings_tags}",
    "bookings.rental": "https://www.bookingsync.com/api/v3/rentals/{bookings.rental}",
    "bookings.rentals_tags": "https://www.bookingsync.com/api/v3/rentals_tags/{bookings.rentals_tags}"
  },
  "bookings": [
    {
      "id": 203,
      "status": "Booked",
      "updated_at": "2021-03-15T10:45:24Z",
      "start_at": "2021-03-22T10:45:24Z",
      "end_at": "2021-03-29T10:45:24Z",
      "links": {
        "account": 1,
        "bookings_tags": [
          1,
          2
        ],
        "rental": 16,
        "rentals_tags": [

        ]
      }
    }
  ],
  "meta": {
  }
}

{
  "links": {
    "bookings.account": "https://www.bookingsync.com/api/v3/accounts/{bookings.account}",
    "bookings.booking_comments": "https://www.bookingsync.com/api/v3/booking_comments/{bookings.booking_comments}",
    "bookings.bookings_fees": "https://www.bookingsync.com/api/v3/bookings_fees/{bookings.bookings_fees}",
    "bookings.bookings_payments": "https://www.bookingsync.com/api/v3/bookings_payments/{bookings.bookings_payments}",
    "bookings.bookings_tags": "https://www.bookingsync.com/api/v3/bookings_tags/{bookings.bookings_tags}",
    "bookings.bookings_taxes": "https://www.bookingsync.com/api/v3/bookings_taxes/{bookings.bookings_taxes}",
    "bookings.client": "https://www.bookingsync.com/api/v3/clients/{bookings.client}",
    "bookings.inquiry": "https://www.bookingsync.com/api/v3/inquiries/{bookings.inquiry}",
    "bookings.payments": "https://www.bookingsync.com/api/v3/payments/{bookings.payments}",
    "bookings.rental": "https://www.bookingsync.com/api/v3/rentals/{bookings.rental}",
    "bookings.rental_agreement": "https://www.bookingsync.com/api/v3/rental_agreements/{bookings.rental_agreement}",
    "bookings.rentals_tags": "https://www.bookingsync.com/api/v3/rentals_tags/{bookings.rentals_tags}",
    "bookings.source": "https://www.bookingsync.com/api/v3/sources/{bookings.source}"
  },
  "bookings": [
    {
      "id": 80,
      "adults": 5,
      "booked": true,
      "bookings_payments_count": 1,
      "channel_price": null,
      "charge_damage_deposit_on_arrival": true,
      "children": null,
      "commission": null,
      "currency": "USD",
      "damage_deposit": "0.0",
      "discount": "10%",
      "downpayment": null,
      "expected_checkin_time": "14:45",
      "expected_checkout_time": "11:30",
      "external_reference": null,
      "final_payback_to_owner": "0.0",
      "final_price": "2700.0",
      "final_rental_price": "2700.0",
      "initial_price": "3000.0",
      "initial_rental_price": "3000.0",
      "locked": null,
      "notes": "",
      "owned_by_app": false,
      "paid_amount": "2700.0",
      "payment_left_to_collect": "0.0",
      "payment_url": null,
      "reference": "0000EG",
      "rental_payback_to_owner": null,
      "review_requests_count": 0,
      "status": "Booked",
      "unavailable": false,
      "created_at": "2021-03-15T10:45:24Z",
      "updated_at": "2021-03-15T10:45:24Z",
      "start_at": "2021-03-22T10:45:24Z",
      "end_at": "2021-03-29T10:45:24Z",
      "canceled_at": null,
      "balance_due_at": "BALANCE_DUE_AT",
      "contract_updated_at": "CONTRACT_2021-03-15T10:45:24Z",
      "tentative_expires_at": null,
      "links": {
        "account": 1,
        "booking_comments": [

        ],
        "bookings_fees": [

        ],
        "bookings_payments": [
          23
        ],
        "bookings_tags": [
          1,
          2
        ],
        "bookings_taxes": [

        ],
        "client": 37,
        "inquiry": null,
        "payments": [
          23
        ],
        "rental": 16,
        "rental_agreement": null,
        "rentals_tags": [

        ],
        "source": null
      }
    }
  ],
  "meta": {
  }
}

Cancel a booking

Required OAuth scope: :bookings_write or :bookings_write_owned

Returns an empty response with ‘204 No Content’ status code on success.

DELETE /bookings/:booking_id