Apinex API Documentation

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()