Get All Hotel Details by Hotel Ids
The Get All Hotel Details by HotelIds API provides comprehensive information for one or more hotels, identified by their unique HotelIds.
It accepts upto a maximum of 100 HotelIds as input and returns complete hotel details, including Name, Address, Region , CityID, Star Rating, Photos and Description and Latitude/Longitude. Additional data fields like SurroundingArea, RoomTypes, PropertyInformation, AreaActivities, PoliciesDisclaimers, DiningFacilities may also be included in the response, offering extended details where available.
This API is primarily used to retrieve full hotel information for purposes such as booking, display, or reporting. It supports both XML and JSON formats.
Including more than 100 HotelIDs in your request will result in a error response.
GetAllHotelsDetailsByHotelIds Request Syntax
Endpoint URL
https://{{URL}} /webapi/staticData/getAllHotelsDetailsByHotelIds
Request Header
HTTP Method : [POST]
Content-Type : [application/xml or application/json]
Accept : [application/xml or application/json]
Request Parameters
| Field | Type | Required | Description |
|---|---|---|---|
|
Org |
string | Yes |
The organisation short code identifying the agent responsible for the request (Agency ID). |
|
User |
string | Yes |
The user’s logon, unique within the given organisation (User Name). |
|
Password |
string | Yes |
Password used for authentication |
|
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 |
Descriptive message about the API result. |
|
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 |
Integer |
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 |
Integer |
Unique identifier of the city. |
|
Id |
Integer |
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. Add “content.stuba.com” in URL as prefix to access the image. |
|
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). |
|
Text |
String |
Contains the actual descriptive content of the room, hotel, or facility. |
Response Samples
Samples
