REST API Method: bookings/fetch-new-confirmed

Fetches a list of confirmed bookings for which the method bookings/fetch-details hasn't been requested yet. Only returns confirmed bookings with a departure day in the future.

URL

http://api.bookingmarkets.com/bookings/fetch-new-confirmed?api_key=your_key

Formats:

• xml
• json

HTTP Method(s):

• POST
• GET (maximum of 2048 characters) 

Requires Authentication:

true

API rate limited:

false

Parameters:

• listing token="XXX". Required. Multiple occurrences possible. Identifies each one of the listings for which the new confirmed bookings are being fetched. Hosts can get the tokens for their listings by visiting the URL /tokens in any of the sites powered by the BookingMarkets Engine (for example: http://localo.com/tokens).

Response

• ok. The request was successfully processed.
  • timestamp. Timestamp of the transaction in UnixTime (GMT).
  • listing token. Identifies the listing for which the booking was made.
    • booking id. The id of the new confirmed booking. Only returns already confirmed bookings for which the method bookings/fetch-details hasn't been requested yet. Additionally, it only returns confirmed bookings with a departure day in the future.
• error. The request wasn't successfully processed.
  • errorcode. Error code.
  • errormessage. Error message explaining the issue.

Examples

Request (XML):

Successful Response:

Failed Response:

Have questions or need help? We are eager to help. Contact us!