Retrieve Property
This endpoint retrieves detailed information about a specific property using its hotel_id and channel_hotel_id.
Endpoint
POST
Attributes
hotel_id alphanumeric (Required)
The unique property ID as assigned by the provider upon creation of the property.
channel_hotel_id string (Required)
The unique id for the hotel on the specific channel.
Sample Request
Response
Sample Success Response
Success Response Body Elements
Status string
The success or failure of the operation.
Ruid string
Specifies the unique request ID.
You can share this ID with Booking.com customer support when you run into an issue. This can help in understanding what went wrong.
Data object
Contains detailed information about the property (the response data).
translations array (of objects)
List of translations for the property details..
position object
Object containing geographical coordinates of the property.
latitude double
Latitude coordinates of the hotel location.
longitude double
Longitude coordinates of the hotel location.
check_in object
Object containing check-in times.
A value of 00:00 for both from and until means the property accepts 24-hour check in.
from enumerated string
Start time for check-in.
until enumerated string
End time for check-in.
check_out object
Object containing check-out times.
A value of 00:00 for both from and until means the property accepts 24-hour check in.
from enumerated string
Start time for check-out.
until enumerated string
End time for check-out (required if check_out > from is specified).
property_name string
Name of the hotel property on Booking.com.
property_category integer
Category identifier for the hotel.
primary_language string
Main preffered language spoken at the property.
languages_spoken array (of strings)
List of languages spoken at the property.
room_count integer
Number of sellable units/rooms available at the hotel.
floor_count integer
The total number of floors in the building/hotel, excluding the underground floors.
currency_code enumerated string
The Booking.com defined currency for the property.
stars string
The number of stars, rating of the hotel.
target enumerated string
Specifies whether it is a test or production-ready property.
Contains one of the following values:
test
production
property_id string
Identifier for the property provider.
Recommended for new properties. For example, the provider's internal ID. Can contain a maximum of 16 characters.
status string
Current status or condition of the property.
Indicates if the property is operational, under renovation, etc.
See allowable values of the statuses and their recommended actions, click Property Status Values and Recommended Actions.
physical_address object
Object containing address details.
city_name string
City where the hotel is located.
country_code enumerated string
ISO code for the country (IN for India).
postal_code string
Postal code of the hotel's location.
address_line string
Detailed address of the hotel.
display_address boolean
Boolean indicating if the address should be displayed.
- true : Shows the full address to the guest.
- false : Hides the full address from the guest.
legal_entity_id string
The unique id for the legal entity associated with the hotel.
Message string
The message in the response.
Provides feedback to users or systems about the request.
Sample Error Response
Error Response Body Elements
Status string
Indicates the result of the API call, which will be always "Fail" in case of an error response.
Error array
Array that contains details about any errors that occurred during the API call. Each object in the Errors array contains the following properties:
Code string
Specific error code that helps identify the type of error.
For example: "400" indicates a bad request.
ShortText string
A short description of the error.
Message string
A message providing more information about the error.
Last updated
Was this helpful?