...
Pricing Information is specific to unit types within a listing. e.g.: a 1 room apartment will have different prices and a maximum number of guests compared to a 2 room apartment.
Integration Steps
Endpoints Available | |||||||
|---|---|---|---|---|---|---|---|
|
| ||||||
|
| ||||||
Step 1: Fetching the Pricing Updates
Make an API call to route
Status colour Blue title GET /v1/updates/pricingto fetch the latest pricing updates.As this is a paginated API, you have to pass the following parameters:
Parameter | Description |
|---|---|
| Each response returns you a |
| The maximum number of pricing updates returned by API. |
If you are integrating with this API for the first time, the
cursorparameter should be omitted. Every subsequent request should contain thecursorthat is provided to you in the previous call’snextfield. That way you can poll for listing updates that happened after the last successful pull.
...
| Code Block |
|---|
curl -X 'GET' \ 'https://chapi.bookiplyholidu.com/v1/updates/pricing?cursor=asJ34sgt&limit=3' \ -H 'Accept: application/json' -H 'Authorization: Bearer SIGNED_JWT' |
...
| Code Block | ||
|---|---|---|
| ||
{
"updates": [
{
"listingId": "1386b2ba-eca5-4adf-9e04-62fc521273f9",
"unitTypeId": "fc033fae-191e-4618-80be-a8ffd48f25fc",
"pricingUrl": "/listings/1386b2ba-eca5-4adf-9e04-62fc521273f9/unit-types/fc033fae-191e-4618-80be-a8ffd48f25fc/pricing",
"version": "951"
},
{
"listingId": "7b1cb9d9-9c58-47ee-8435-72a536eadedc",
"unitTypeId": "507e2397-11a8-455f-b845-e7224d09093b",
"pricingUrl": "/listings/7b1cb9d9-9c58-47ee-8435-72a536eadedc/unit-types/507e2397-11a8-455f-b845-e7224d09093b/pricing",
"version": "956"
},
{
"listingId": "cd7adf70-6be7-4b6a-a0f9-924fabe442e2",
"unitTypeId": "b7fc3c34-749f-419c-bb32-c3de5e59767d",
"pricingUrl": "/listings/cd7adf70-6be7-4b6a-a0f9-924fabe442e2/unit-types/b7fc3c34-749f-419c-bb32-c3de5e59767d/pricing",
"version": "957"
}
],
"next": "JSMjIwtNQ1sNAJRykxRsjK0MD"
} |
Parameter | Description |
|---|---|
| Unique id of the listing |
| Unique id of the unit type under the listing |
| The pricing URL which can be used to fetch the pricing |
| An unique identifier, specifying the update version in a global incremental series for every update. If version is 20, this means that this is the 20th update on Listing or Pricing in our inventory. |
Step 2: Processing the Pricing Update
...
| Code Block |
|---|
curl -X 'GET' \ 'https://chapi.bookiplyholidu.com/v1/listings/1386b2ba-eca5-4adf-9e04-62fc521273f9/unit-types/fc033fae-191e-4618-80be-a8ffd48f25fc/pricing' \ -H 'Accept: application/json' -H 'Authorization: Bearer SIGNED_JWT' |
...
| Code Block | ||
|---|---|---|
| ||
{
"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": [
0,
80.25,
120.65,
150.59
],
"currency": "EUR",
"maxOccupancy": 2
},
{
"price": [
0,
90.25,
130.15,
160.65
],
"currency": "EUR",
"maxOccupancy": 3
}
],
"2022-04-27": [
{
"price": [
0,
80.25
],
"currency": "EUR",
"maxOccupancy": 2
},
{
"price": [
0,
90.25
],
"currency": "EUR",
"maxOccupancy": 3
}
]
}
}
} |
...
| Code Block |
|---|
"2022-04-26": [
{
"price": [
0,
80.25,
120.65,
150.59
],
"currency": "EUR",
"maxOccupancy": 2
},
{
"price": [
0,
90.20,
130.32,
160.90
],
"currency": "EUR",
"maxOccupancy": 3
}
] |
A 1-night stay on check-in date
2022-04-26is not possible since the price is 0A 2-nights stay on check-in date
2022-04-26costs 80 euros for 2 guests and 90 euros for 3 guests. Similarly for 3 and 4 nights.It is not possible to have a stay longer than 4 nights for check-in date
2022-04-26.
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.
...