GET/larBarRates

Get LAR BAR Rates

This API call enables you to retrieve rate data once the shop has been completed, using the shopId as an input parameter.
GET/larBarRates

Important Notes

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.

Parameter Details

NameInTypeRequiredDescription
» shopIdpathintegerRequiredSpecifies the ID of the shop for which you want to retrieve the last execution log.
» pageNumberqueryintegerOptionalNone
» limitqueryintegerOptionalNone

Responses

StatusMeaningDescriptionSchema
200OKWebhook created successfully
400Bad RequestBad RequestNone
401UnauthorizedAuthentication Failed or Account validity ExpiredNone
429Too Many RequestsToo Many RequestsNone
500Internal Server ErrorInternal Server ErrorNone

Example Request

# You can also use wget
curl -X GET /hotel-details \
  -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.