Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
languagejson
{
  "listingId": "1386b2ba-eca5-4adf-9e04-62fc521273f9",
  "unitTypeId": "fc033fae-191e-4618-80be-a8ffd48f25fc",
  "availabilities": [
    {
      "date": "2022-04-26",
      "unitsAvailable": 1
    },
    {
      "date": "2022-04-27",
      "unitsAvailable": 1
    }
  ],
  "losRecords": {
      "los": {
        "2022-04-26": [
          {
            "price": [
              400,
              80,
              120,
              150
            ],
            "currency": "EUR",
            "maxOccupancy": 2
          },
          {
            "price": [
              500,
              90,
              130,
              160
            ],
            "currency": "EUR",
            "maxOccupancy": 3
          }
        ],
        "2022-04-27": [
          {
            "price": [
              0,
              80
            ],
            "currency": "EUR",
            "maxOccupancy": 2
          },
          {
            "price": [
              0,
              90
            ],
            "currency": "EUR",
            "maxOccupancy": 3
          }
        ]
      }
    }
}

The sample response for los above indicates that 2022-04-26 and 2022-04-27 are available checkin dates with a possibility to book for upto 4 nights on 2022-04-26 and 2 nights on 2022-04-27. The number of prices in the price list indicates the number of nights possible to book from the checkin date.

E.g.:

  • 3 nights stay on checkin date 2022-04-26 costs 120 euros for 2 guests and 130 euros for 3 guests. Max stay for this checkin date is 4 nights.

  • 1 night stay on checkin date 2022-04-27 is not possible as the price is 0 and the cost for 2 nights is 80 for 2 guests and 90 for 3 guests. Max stay for this checkin date is 2 nights.

LOS Structure

Code Block
"losRecords": {
      "los": {
        "CHECK-IN_DATE": [
          {
            "price": [
              PRICE_FOR_1_DAYNIGHT,
              PRICE_FOR_2_DAYSNIGHTS,
              PRICE_FOR_3_DAYSNIGHTS,
              PRICE_FOR_4_DAYSNIGHTS
            ],
            "currency": "EUR",
            "maxOccupancy": MAX_NUMBER_OF_GUESTS
          }
       ]
    }
}

The los object contains a list of available checkin dates. Each CHECK-IN_DATE has an array of price objects based on max number of guests. The number of prices in the price list indicates the number of nights possible to book from the checkin date.

Example:

Code Block
"2022-04-26": [
    {
        "price": [
          0,
          80,
          120,
          150
        ],
        "currency": "EUR",
        "maxOccupancy": 2
    },
    {
        "price": [
          0,
          90,
          130,
          160
        ],
        "currency": "EUR",
        "maxOccupancy": 3
    }
]
  • 1 night stay on checkin date 2022-04-26 is not possible since the price is 0

  • 2 nights stay on checkin date 2022-04-26 costs 80 euros for 2 guests and 90 euros for 3 guests. Similarly for 3 and 4 nights.

  • Max stay for this checkin date is 4 nights.

Sync Frequency

To ensure the latest listing availability and prices, partners should regularly poll the pricing updates. The pricing updates API can be polled up to the interval specified in the Rate limiting. We recommend that you poll it multiple times per minute to avoid overbookings. We also recommend reconfirming the availability of the property before processing the new booking. This can be done by fetching the same price update for specific listing & unit type as shown above.

...