Get All Hotel Details by Hotel Ids
This API retrieves detailed information for one or more hotels using their unique hotel IDs.
The Get All Hotel Details by HotelIds API retrieves complete information for one or more specific hotels.
It takes HotelIds as input and returns detailed hotel data such as Name, Address, Region, Contact Details, Ratings, Latitude/Longitude
Some additional fields may also be available from the XML response.
This API is mainly used to fetch full hotel details for booking, display, or reporting purposes.It supports both XML and JSON formats and returns complete hotel information,including name, address, star rating, coordinates, and region details.
GetAllHotelsDetailsByHotelIds Request Syntax
Request Header
HTTP Method : [POST]
Content-Type : [application/xml or application/json]
Accept : [application/xml or application/json]
Authentication : [Based on Org, User, and Password in the request body.]
Request Parameters
| Field | Type | Required | Description |
|---|---|---|---|
|
Org |
string | Yes |
Organization code used for authentication |
|
User |
string | Yes |
Username used for authentication |
|
Password |
string | Yes |
Password used for authentication |
|
Language |
string | Yes |
Language preference (e.g., “en”) |
|
HotelIds |
array | Yes |
One or more hotel IDs to retrieve details for |
Response Parameters
| Field | Type | Description |
|---|---|---|
|
Success |
Boolean |
Indicates if the API call was successful (true / false). |
|
Message |
String |
Describes the result of the request (e.g., “Hotel details fetched successfully”). |
|
Data |
Array of HotelSearchResult |
Contains list of hotel search result objects. |
HotelSearchResult Object
| Field | Type | Description |
|---|---|---|
|
HotelElement |
Object |
Contains full details of the hotel. |
|
Xsd |
String |
XML schema definition reference URL. |
|
Xsi |
String |
XML schema instance reference URL. |
HotelElement Object
| Field | Type | Description |
|---|---|---|
|
Id |
Int |
Unique identifier of the hotel. |
|
Name |
String |
Name of the hotel. |
|
Region |
Object |
Contains region and city information. |
|
Address |
Object |
Full address details of the hotel. |
|
Stars |
Integer |
Star rating of the hotel. |
|
GeneralInfo |
Object |
Latitude and longitude details. |
|
Photo |
Object |
URL or reference to hotel photos (if available). |
|
Description |
Object |
Hotel description (if available). |
|
Rating |
Object |
Rating details (system and score). |
Region Object
| Field | Type | Description |
|---|---|---|
|
CityId |
Int |
Unique identifier of the city. |
|
Id |
Int |
Region or city ID (same as CityId here). |
|
Name |
String |
Name of the region or city. |
Address Object
| Field | Type | Description |
|---|---|---|
|
Address1 |
String |
Primary address line. |
|
Address2 |
String |
Secondary address line. |
|
Address3 |
String |
Additional address line. |
|
City |
String |
City name. |
|
State |
String |
State name (if available). |
|
Zip |
String |
Postal or ZIP code. |
|
Country |
String |
Country name. |
|
Tel |
String |
Contact telephone number. |
GeneralInfo Object
| Field | Type | Description |
|---|---|---|
|
Latitude |
String |
Latitude coordinate of the hotel. |
|
Longitude |
String |
Longitude coordinate of the hotel. |
Rating Object
| Field | Type | Description |
|---|---|---|
|
System |
String |
Rating system used (e.g., “Stars”). |
|
Score |
Integer |
Rating score based on the system. |
Photo Object
| Field | Type | Description |
|---|---|---|
|
Url |
String |
Path or URL of the image file. It points to the location where the photo is stored . |
|
Width |
Integer |
Width of the photo in pixels. |
|
Height |
Integer |
Height of the photo in pixels. |
|
Bytes |
Integer |
Size of the image file in bytes (0 if not provided). |
|
Caption |
String |
Description or label of the photo |
|
ThumbnailWidth |
Integer |
Width of the thumbnail version of the photo in pixels. |
|
ThumbnailHeight |
Integer |
Height of the thumbnail version of the photo in pixels. |
|
ThumbnailBytes |
Integer |
Size of the thumbnail image in bytes . |
|
PhotoType |
Integer |
Numeric code representing the type or category of the photo . |
Description Object
| Field | Type | Description |
|---|---|---|
|
Language |
String |
Specifies the language code of the description text (e.g., “en” for English). |
|
Type |
String |
Indicates the description type (e.g., RoomTypes). |
|
Test |
String |
Contains the actual descriptive content of the room, hotel, or facility. |
Response Samples
Samples
