GET
/larBarRates/{shopId}Getlarbarrates
Get LAR BAR Rates
Implementation Notes
This API call enables you to retrieve rate data once the shop has been completed, using the shopId as an input parameter.
Mandatory parameter:
shopId
Schema Description:
shopId:Unique ID for the specific rateshop.queueId:Queue IDs associated with the crawl process.dtCollected:Crawl date and time in UTC.websiteCode:Unique code for each website (2 - Booking, 1 - Expedia, etc.).checkIn:Specific date for the check-in.checkOut:Specific date for the check-out.los:Length of stay.pos:This parameter decides the rateshop call be made from which region to extract rates.guests:Number of guests staying.hotelId:Unique ID assigned by the source such as Booking.com.hotelCode:Unique ID for the specific hotel.hotelName:Name of the property.sourceUrl:Direct link of the check-in page.address:Street address.cityDistrict:City or district where the hotel is located.state:State or province of the property.country:Country name of the property.latitude:Latitude coordinate of the property location.longitude:Longitude coordinate of the property location.currency:Price currency.isLAR:Indicates the rate type for the property. False refers to "BAR" and True refers to "LAR".propertyType:The classification or type of property (e.g., hotel, resort, apartments).roomType:Room type as described on the source webpage.roomDescription:Detailed room description content.roomAmenities:Amenities offered for the room.mapLink:Map view link of the property on the source website.roomAvailable:Availability status of the room.roomLeft:Number of rooms left for booking on the source site.reviewRating:Average rating of the hotel based on guest reviews.reviewsCount:Total number of guest reviews received by the hotel.taxAmount:Contains the taxable value.taxType:Contains the tax information fetched from the pricing page.taxStatus:Possible values are -1, 1, 2, 3 where -1 denotes tax information not available, 1 denotes tax included in rate, 2 denotes tax not included in rate, and 3 denotes tax partially included in rate.mealPlan:Meal plan information offered for the room (Free Breakfast, Full board, Half board, etc.).ratePlan:Rate conditions like Free cancellation, Refundable, Non-refundable, etc.locationRating:Location score.promo:Promotion details.ratingText:Qualitative rating description.onsiteRate:Actual rate at which the hotel room is available.netRate:Rate of the hotel room before discount.discount:Discount amount (percentage).occupancy:Maximum number of guests the specific room can accommodate.paymentType:Payment options such as "Pay now" or "Pay later".rankingListingCount:Number of total listings ranked for the property's position.navigationPage:Page number in pagination when scraping.newArrival:Indicates if the property is newly added.distanceHotel:Distance from a central location or reference point.otherInformation:Additional data not covered by defined fields.statusCode:Status of the record. Possible values include 200, 202, and 204.destId:Unique ID for the specific destination.htlRating:Star rating provided by the property to Booking.com.aptRating:Rating awarded to apartment-like properties by Booking.com.dotsRating:Dot rating provided by Booking.com for properties.preferredPartner:Indicates whether the property is part of Booking.com's Preferred Partner Program.preferredPlus:Indicates whether the property is part of Booking.com's Preferred Plus Program.destType:Destination type for the specific destination.neighbourhood:Neighbourhood where the hotel is located.searchCity:The city that was used to search for the property.
GET
/larBarRates/{shopId}Parameter Details
| Name | In | Type | Required | Description |
|---|---|---|---|---|
shopId | path | integer | Required | none |
pageNumber | query | integer | Optional | none |
limit | query | integer | Optional | none |
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | OK | |
| 400 | Bad Request | Bad Request | None |
| 401 | Unauthorized | Authentication Failed or Account validity Expired | None |
| 429 | Too Many Requests | Too Many Requests | None |
| 500 | Internal Server Error | Internal Server Error | None |
Example Request
# You can also use wget
curl -X GET /larBarRates/{shopId} \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
Example responses
200 Response
{
"shopId": 12904,
"queueId": 22619,
"dtCollected": "2026-05-29T10:02:19.306Z",
"websiteCode": 2,
"checkIn": "2026-05-31T00:00:00.000Z",
"checkOut": "2026-06-01T00:00:00.000Z",
"los": 1,
"pos": 0,
"guests": 1,
"hotelId": 38107214525421,
"hotelCode": 0,
"hotelName": "Near To CCBC ESSEX Room 201",
"sourceUrl": "https://www.booking.com/hotel/us/near-to-ccbc-essex-private-room-201.en-gb.html",
"address": "33 Bernadotte Ct",
"cityDistrict": "Parkville",
"state": "Maryland",
"country": "United States",
"latitude": "39.4025228",
"longitude": "-76.4847339",
"currency": "USD",
"isLAR": true,
"propertyType": "Homestays",
"roomType": "Double Room",
"roomDescription": "bedrooms 0, Kitchen 0, beds 1, living room 0, bathroom 0",
"roomAmenities": "",
"mapLink": "https://www.booking.com/hotel/us/near-to-ccbc-essex-private-room-201.en-gb.html?map=1",
"roomAvailable": "1",
"roomLeft": "1",
"reviewRating": 9,
"reviewsCount": 1,
"taxAmount": 0,
"taxType": "Included",
"taxStatus": 1,
"mealPlan": "Breakfast included",
"ratePlan": "FreeCancellation",
"locationRating": 10,
"promo": "",
"ratingText": "Superb",
"onsiteRate": 111.61,
"netRate": 0,
"discount": 0,
"occupancy": 1,
"paymentType": "Pay at the property",
"rankingListingCount": 1,
"navigationPage": 1,
"newArrival": "",
"distanceHotel": 5.5,
"otherInformation": "",
"statusCode": 200,
"destId": "20058854",
"otherRatings": {
"htlRating": 0,
"aptRating": 0,
"dotsRating": 0
},
"ratingFlags": {
"preferredPartner": false,
"preferredPlus": false
},
"destType": "CITY",
"neighbourhood": "Parkville",
"searchCity": "Parkville"
}
Need Support?
Our team is here to help you integrate and make the most of our APIs. Get in touch for technical support, custom solutions, or any questions.