Get hotel detail
Fetch full details for a specific hotel using its Giata ID. Use this to display hotel information โ photos, amenities, policies โ on your detail page before the guest selects a room.
`GET /api/Hotel/details/
Returns comprehensive information about a hotel property.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
giataId |
string | Yes | The hotel's Giata ID (returned in search results) |
Example request
GET /api/Hotel/details/12345
X-Api-Key: your_api_key
Example response
{
"giataId": 12345,
"name": "Grand Hyatt Dubai",
"starRating": 5,
"address": {
"line1": "Baniyas Road",
"city": "Dubai",
"country": "United Arab Emirates",
"countryCode": "AE",
"postalCode": "00000"
},
"coordinates": {
"latitude": 25.2288,
"longitude": 55.3273
},
"description": "The Grand Hyatt Dubai is a luxury hotel located on the banks of the Dubai Creek...",
"images": [
{ "url": "https://images.travelexe.com/hotels/12345/exterior.jpg", "caption": "Hotel exterior" },
{ "url": "https://images.travelexe.com/hotels/12345/pool.jpg", "caption": "Swimming pool" },
{ "url": "https://images.travelexe.com/hotels/12345/room-deluxe.jpg", "caption": "Deluxe room" }
],
"amenities": [
"Swimming pool", "Spa", "Fitness center", "Free WiFi",
"Restaurant", "Bar", "Airport shuttle", "Business center"
],
"checkInTime": "15:00",
"checkOutTime": "12:00",
"policies": {
"pets": "Not allowed",
"smoking": "Non-smoking property",
"children": "Children of all ages welcome"
}
}
Find hotels by Giata ID
If you have a hotel name and want its Giata ID, use this endpoint:
POST /api/Hotel/giataids
| Field | Type | Required | Description |
|---|---|---|---|
city |
string | No | City name |
hotel_name |
string | No | Hotel name to search |
star_rating |
string | No | Filter by star rating |
Example request
POST /api/Hotel/giataids
X-Api-Key: your_api_key
Content-Type: application/json
{
"city": "Dubai",
"hotel_name": "Grand Hyatt",
"star_rating": "5"
}
Find nearby hotels
Given a hotel's Giata ID, find other hotels near the same property:
POST /api/Hotel/nearby
| Field | Type | Required | Description |
|---|---|---|---|
giata_id |
int64 | Yes | The reference hotel's Giata ID |
Example request
POST /api/Hotel/nearby
X-Api-Key: your_api_key
Content-Type: application/json
{
"giata_id": 12345
}
Code samples
var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Api-Key", "your_api_key");
var response = await client.GetAsync(
"https://api.travelexe.com/api/Hotel/details/12345");
var hotel = await response.Content.ReadFromJsonAsync<HotelDetail>();
const hotel = await fetch('https://api.travelexe.com/api/Hotel/details/12345', {
headers: { 'X-Api-Key': 'your_api_key' }
}).then(r => r.json());
import requests
hotel = requests.get(
'https://api.travelexe.com/api/Hotel/details/12345',
headers={'X-Api-Key': 'your_api_key'}
).json()