New API available

Great news, we just opened a new world of possibilities based on your favorite vacation rental platform :)

Check the latest BookingSync API

The API described bellow will be retired May 1st, 2016

MyBookings

Public   Deprecated

List all

GET /mybookings/#{ACCOUNT_ID}.xml

Returns a public list of all bookings from the account specified by the integer ACCOUNT_ID.
It returns only bookings within the upcoming year.

Parameters

  • from. Optional. Retrieves bookings since from until next year from today. from shall be within the upcomming year or will be ignored. (format: yyyymmdd and in UTC)
    • Example: http://www.bookingsync.com/mybookings/1.xml?from=20100114
  • months. Optional. Retrieves bookings for the number of months defined by months. months shall be within 1 and 12 or will be ignored. (default: 12)
    • Example: http://www.bookingsync.com/mybookings/1.xml?months=1
  • page. Optional. Specifies the page of bookings to retrieve. (default: 1)
    • Example: https://www.bookingsync.com/mybookings.xml?page=2
  • per_page. Optional. Specifies the maximum number of bookings to return per page. (default: 500, maximum: 500)
    • Example: https://www.bookingsync.com/mybookings.xml?per_page=10

Response

Status: 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<bookings type="array">
  <booking>
    <status>Booked</status>
    <start-at type="datetime">2010-03-12T16:00:00Z</start-at>
    <end-at type="datetime">2010-03-13T10:00:00Z</end-at>
    <rental-id type="integer">1</rental-id>
  </booking>
  <booking>
    ...
  </booking>
  ...
</bookings>

List all within rental

GET /mybookings/#{ACCOUNT_ID}/rentals/#{RENTAL_ID}.xml

Returns a public list of all bookings from the account specified by the integer ACCOUNT_ID and made for the rental specified by the integer RENTAL_ID.
It returns only bookings within the upcoming year.

Parameters

Use the same parameters as "List all"

Response

Status: 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<bookings type="array">
  <booking>
    ...
  </booking>
  <booking>
    ...
  </booking>
  ...
</bookings>