Quick start

Make your first TravelExe API call in under 5 minutes.

Step 1 — Get your API key

Contact the TravelExe team to receive your X-Api-Key. Every request requires this key in the header.

Step 2 — Search for hotels

Send a POST request to search hotels in a city:

POST /api/Hotel/search
X-Api-Key: your_api_key
Content-Type: application/json

{
  "city_id": "DXB",
  "checkin": "2026-08-01T00:00:00",
  "checkout": "2026-08-05T00:00:00",
  "currency": "USD",
  "client_nationality": "IN",
  "user_id": 1001,
  "cutoff_time": 24,
  "rooms": [
    { "adults": "2", "children_ages": [] }
  ]
}

Step 3 — Poll for results

The search is asynchronous. Use the searchId from the response to fetch results:

GET /api/Hotel/search/{searchId}
X-Api-Key: your_api_key

Step 4 — Get room options

Once you have a hotel's giataId, fetch available rooms:

POST /api/Hotel/rooms
X-Api-Key: your_api_key
Content-Type: application/json

{
  "search_id": "abc123",
  "checkin": "2026-08-01T00:00:00",
  "checkout": "2026-08-05T00:00:00",
  "currency": "USD",
  "client_nationality": "IN",
  "user_id": 1001,
  "stacked": false,
  "rooms": [
    { "adults": "2", "children_ages": [] }
  ]
}

Step 5 — Prebook, then book

Always prebook before confirming — this validates the rate and locks pricing:

POST /api/Hotel/prebook

Then confirm with:

POST /api/Hotel/book