API docs by Redocly

ITT Hotel API (1.0.0)

Download OpenAPI specification:

Hotel API endpoints converted from Postman collection.

Hotel

Hotel search, pricing, booking, ancillaries and post-booking flows.

Hotel Search & Pricing

Get auto-suggestions for hotel search locations

Authorizations:
(apiKeyAuthsecretCodeAuth)
Request Body schema: application/json
required
location
required
string

Location name or partial name for hotel autocomplete/search

property name*
additional property
any

Responses

Response Schema: application/json
property name*
additional property
any

Request samples

Content type
application/json
{
  • "location": "paris"
}

Response samples

Content type
application/json
Example
[
  • {
    • "location": "Paris, France"
    },
  • {
    • "location": "Paris, TX, USA"
    },
  • {
    • "location": "Paris Expo Porte de Versailles, Place de la Porte de Versailles, Paris, France"
    },
  • {
    • "location": "Paris Las Vegas, South Las Vegas Boulevard, Las Vegas, NV, USA"
    },
  • {
    • "location": "Paris Orly Airport (ORY), Orly, France"
    }
]

hotel search by location and occupancies

Authorizations:
(apiKeyAuthsecretCodeAuth)
Request Body schema: application/json
required
location
required
string

Hotel search location

partner_id
required
string

Partner account ID

checkIn
required
string <date>

Check-in date (YYYY-MM-DD)

checkOut
required
string <date>

Check-out date (YYYY-MM-DD)

required
object
guest_nationality
string

Nationality of the guest (ISO country code)

supplier_uid
string

Supplier unique ID (optional)

radius
string

Search radius around location (e.g., auto / 5km)

breakfast_option
string

Breakfast preference filter (any / included / excluded)

hotel_star_level
string

Filter by hotel star rating (any / 3 / 4 / 5)

property name*
additional property
any

Responses

Response Schema: application/json
property name*
additional property
any

Request samples

Content type
application/json
Example
{
  • "location": "Dubai - United Arab Emirates",
  • "partner_id": "1",
  • "guest_nationality": "BD",
  • "supplier_uid": "H1AS00029",
  • "checkIn": "2025-07-09",
  • "checkOut": "2025-07-10",
  • "radius": "auto",
  • "breakfast_option": "any",
  • "hotel_star_level": "any",
  • "occupancies": [
    • {
      },
    • {
      }
    ],
  • "short_ref": "b1da9390..."
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "reason": "Your destination search yielded results for 194 hotels.",
  • "tracking_id": "11177173317126194WKNKI",
  • "search_duration_seconds": "42 seconds",
  • "search_total_block": "24,",
  • "search_total_hotel": "1741,",
  • "total_hotel": "194,",
  • "before_mapping_total_hotel": "233,",
  • "name_match_mapping_addon": "null,",
  • "ResultPercentage": "0.00%",
  • "search_parameter": {
    • "tracking_id": "11771733169CCL1",
    • "location": "Dhaka, Bangladesh",
    • "radius": "auto",
    • "search_radius": "17,",
    • "unit": "km",
    • "checkIn": "2026-03-15",
    • "checkOut": "2026-03-21",
    • "total_night": "6",
    • "total_room": "1,",
    • "total_adult": "2,",
    • "total_child": "0,",
    • "occupancies": {
      },
    • "guest_nationality": "BD",
    • "hotel_star_level": "any",
    • "search_currency": "null,",
    • "latitude": "23.804093,",
    • "longitude": "90.4152376,",
    • "country_name": "Bangladesh",
    • "country_code": "BD",
    • "city_name": "Dhaka",
    • "city_code": "Dhaka",
    • "area_name": "null,",
    • "area_code": "null,",
    • "supplier_uid": "all",
    • "hotel_mapping_count": 1792
    },
  • "data": {
    • "uid": "36,",
    • "hotel_id": "H1EA00004#17350009",
    • "vervotechId": "15712948",
    • "giataId": "725793",
    • "tracking_id": "11771733169CCL1",
    • "room_tracking_id": "11771733169CCL1-H1EA00004-36",
    • "hotel_name": "White House Guest House",
    • "hotel_name_code": "white-house-guest-house",
    • "property_type": "Guesthouse",
    • "room_title": "Dormitory Room",
    • "promo_tag": "Save:7%",
    • "rate_type": "Bed-Breakfast",
    • "star_rating": "3,",
    • "rating_average": "null,",
    • "primary_photo": "https://i.travelapi.com/lodging/18000000/17360000/17350100/17350009/ec5cf8b2_z.jpg",
    • "address": "10B/1, Road 51, Unit B1, Gulshan 2",
    • "latitude": "23.8011",
    • "longitude": "90.4145",
    • "distance_km": "0.34116",
    • "currency": "BDT",
    • "total_amount": "28180.83,",
    • "sell_price": "28180.83,",
    • "sell_per_night": "28180.83,",
    • "supplier": {
      },
    • "free_cancellation": "36,",
    • "facility": [
      ],
    • "search_result_logs_url": "https://temp-logs.example.com/hotel_logs/11177173317126194WKNKI/search_result.json"
    }
}

Single Hotel availability for a specific hotel and room.

Authorizations:
(apiKeyAuthsecretCodeAuth)
Request Body schema: application/json
required
hotel_id
required
string

Unique hotel identifier

checkIn
required
string <date>

Check-in date in YYYY-MM-DD format

checkOut
required
string <date>

Check-out date in YYYY-MM-DD format

required
Array of objects

Room occupancies

guest_nationality
string

Nationality of guest (ISO country code)

property name*
additional property
any

Responses

Response Schema: application/json
property name*
additional property
any

Request samples

Content type
application/json
{
  • "hotel_id": "H1AS00029#RTPARDAM#PAR",
  • "checkIn": "2025-07-02",
  • "checkOut": "2025-07-03",
  • "occupancies": [
    • {
      }
    ],
  • "guest_nationality": "BD"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "tracking_id": "11170398842026238CWCML",
  • "search_parameter": {
    • "hotel_id": "H10004#770081",
    • "checkIn": "2024-02-11",
    • "checkOut": "2024-02-12",
    • "occupancies": [
      ],
    • "guest_nationality": "SG",
    • "total_night": "1"
    },
  • "session_expire": {
    • "timestamp": 1703990222,
    • "datetime": "2023-12-31 10:37:02 +08",
    • "message": "The booking process should be completed by no later than 2023-12-31 10:37:02 +08."
    },
  • "response_data": [
    • {
      },
    • {
      }
    ]
}

Single hotel Details Content.

Authorizations:
(apiKeyAuthsecretCodeAuth)
Request Body schema: application/json
required
hotel_id
required
string

Unique hotel identifier

property name*
additional property
any

Responses

Response Schema: application/json
property name*
additional property
any

Request samples

Content type
application/json
{
  • "hotel_id": "H1AS00029#RTPARDAM#PAR"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "hotel_id": "17350009",
  • "supplier_code": "ean",
  • "travelgate_supplier_code": "",
  • "last_update": "Saturday, 2025-04-26 9:54 PM +06:00",
  • "data": {
    • "created": "2025-04-26T15:54:10Z",
    • "timestamp": "1745682850",
    • "hotel_id": "17350009",
    • "name": "White House Guest House",
    • "name_local": "White House Guest House",
    • "hotel_formerly_name": "White House Guest House",
    • "brand_text": "null,",
    • "property_type": "Guesthouse",
    • "star_rating": "3.0",
    • "chain": "Independent",
    • "brand": "Independent",
    • "logo": "null,",
    • "primary_photo": "https://i.travelapi.com/lodging/18000000/17360000/17350100/17350009/ec5cf8b2_z.jpg",
    • "review_rating": {
      },
    • "policies": {
      },
    • "address": {
      },
    • "amenities": {
      },
    • "facilities": [
      ],
    • "hotel_photo": {},
    • "point_of_interests": {
      },
    • "train_stations": [
      ],
    • "connected_locations": {
      },
    • "neighbourhoods": {
      },
    • "stadiums": {
      }
    }
}

Get Price and Policy validation validation details.

Authorizations:
(apiKeyAuthsecretCodeAuth)
Request Body schema: application/json
required
tracking_id
required
integer

Search tracking ID from hotel search response

room_tracking_id
required
string

Unique room tracking identifier

property name*
additional property
any

Responses

Response Schema: application/json
property name*
additional property
any

Request samples

Content type
application/json
{
  • "tracking_id": 11171005026802720,
  • "room_tracking_id": "11175108883326193VKD98-H1AS00029-0"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "tracking_id": "11177174741026194FHMV2",
  • "room_tracking_id": "11177174741026194FHMV2-H1TL00142-0",
  • "booking_tracking_id": "111771747633261941E6VT",
  • "price_change": "no-change",
  • "search_price": {
    • "currency": "BDT",
    • "amount": 10014.46
    },
  • "validation_price": {
    • "currency": "BDT",
    • "amount": 10014.46
    },
  • "session_expire": {
    • "timestamp": 1771748533,
    • "datetime": "2026-02-22 14:22:13 +06",
    • "message": "The booking process should be completed by no later than 2026-02-22 14:22:13 +06."
    },
  • "search_parameter": {
    • "hotel_id": "H1TL00142#KGB1097616",
    • "checkIn": "2026-03-15",
    • "checkOut": "2026-03-16",
    • "total_night": "1",
    • "total_room": 2,
    • "total_adult": 4,
    • "total_child": 0,
    • "occupancies": [
      ],
    • "guest_nationality": "BD",
    • "country_code": null,
    • "supplement_key": null
    },
  • "data": {
    • "summery": null,
    • "tracking_id": "11177174741026194FHMV2",
    • "room_tracking_id": "11177174741026194FHMV2-H1TL00142-0",
    • "hotel_id": "H1TL00142#KGB1097616",
    • "title": "DOUBLE CLUB QUEEN BED",
    • "room_category": "club-room",
    • "room_category_name": "Club Room",
    • "room_category_priority": 15,
    • "promo_price_tag": false,
    • "total_amount": 10014.46,
    • "sell_total_price": 10014.46,
    • "currency": "BDT",
    • "sales_commission": 0,
    • "supplier": {
      },
    • "hold_possible": "no",
    • "policies": {
      }
    },
  • "data()": [
    • {
      },
    • {
      }
    ]
}

Get Get-Price validation details

Authorizations:
(apiKeyAuthsecretCodeAuth)
Request Body schema: application/json
required
booking_tracking_id
required
string

Unique booking tracking ID

member_id
required
string

Member account ID

property name*
additional property
any

Responses

Response Schema: application/json
property name*
additional property
any

Request samples

Content type
application/json
{
  • "booking_tracking_id": "111771747633261941E6VT",
  • "member_id": "1"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "booking_tracking_id": "111771747633261941E6VT",
  • "tracking_id": "11177174741026194FHMV2",
  • "room_tracking_id": "11177174741026194FHMV2-H1TL00142-0",
  • "price_change": "no-change",
  • "search_price": {
    • "currency": "BDT",
    • "amount": 10014.46
    },
  • "validation_price": {
    • "currency": "BDT",
    • "amount": 10014.46
    },
  • "session_expire": {
    • "timestamp": "1771748533,",
    • "datetime": "2026-02-22 14:22:13 +06",
    • "message": "The booking process should be completed by no later than 2026-02-22 14:22:13 +06."
    },
  • "search_parameter": {
    • "hotel_id": "H1TL00142#KGB1097616",
    • "checkIn": "2026-03-15",
    • "checkOut": "2026-03-16",
    • "total_night": "1",
    • "total_room": "2,",
    • "total_adult": "4,",
    • "total_child": "0,",
    • "occupancies": [
      ],
    • "guest_nationality": "BD",
    • "country_code": null,
    • "supplement_key": null,
    • "data": {
      },
    • "price": {
      },
    • "fmg": {
      },
    • "post_booking_process": "auto",
    • "book_now_pay_later": "no"
    },
  • "guest_data": [ ],
  • "hotel_contents": {
    • "status": "success",
    • "hotel_id": "KGB1097616",
    • "supplier_code": "travelrobothotel",
    • "travelgate_supplier_code": "Test_020126",
    • "last_update": "Thursday, 1970-01-01 6:00 AM +06:00",
    • "data": {
      },
    • "policies": {
      },
    • "address": {
      }
    }
}

Guest & Information Updates

Update travellers for a booking.

Authorizations:
(apiKeyAuthsecretCodeAuth)
Request Body schema: application/json
required
tracking_id
required
string

Booking tracking ID from hotel booking step

member_id
required
string

Logged-in member account ID

required
Array of objects

List of passengers for hotel booking

save_pax
string

Save passenger details for future bookings (yes / no)

property name*
additional property
any

Responses

Response Schema: application/json
property name*
additional property
any

Request samples

Content type
application/json
{
  • "tracking_id": "111771747633261941E6VT",
  • "member_id": "1",
  • "save_pax": "yes",
  • "passenger": [
    • {
      },
    • {
      },
    • {
      },
    • {
      }
    ]
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "reason": "Passenger data has been successfully updated.",
  • "tracking_id": "111771747633261941E6VT",
  • "total_guest": "2,",
  • "data": [
    • {
      },
    • {
      }
    ]
}

Booking Management

Create booking.

Authorizations:
(apiKeyAuthsecretCodeAuth)
Request Body schema: application/json
required
tracking_id
required
string

Booking tracking ID from previous booking step

contact_no
required
string

Customer contact number

email_address
required
string <email>

Customer email address

payment_type
required
string

Payment method (e.g., account_balance, card, online_payment)

member_id
required
string

Logged-in member account ID

room_tracking_id
string

Selected room tracking ID (if applicable)

isd_code
string

ISD code for customer contact number

redirect_url
string <uri>

URL to redirect after booking confirmation

agency_isd_code
string

Agency ISD code

agency_contact_no
string

Agency contact number

agency_email
string <email>

Agency email address

special_requests_notes
string

Additional special requests or notes for the booking

property name*
additional property
any

Responses

Response Schema: application/json
property name*
additional property
any

Request samples

Content type
application/json
{
  • "tracking_id": 11175108883326192,
  • "room_tracking_id": "11175108883326193VKD98-H1AS00029-0",
  • "isd_code": "1",
  • "contact_no": "01700000000",
  • "email_address": "sandbox@example.com",
  • "payment_type": "account_balance",
  • "redirect_url": "https://agent.example.com/booking-details/hotel",
  • "agency_isd_code": "1",
  • "agency_contact_no": "01700000000",
  • "agency_email": "sandbox@example.com",
  • "member_id": "1",
  • "special_requests_notes": "n/a"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "reason": "The booking has been successfully created, and it is associated with the Booking Id HO2622FEIDACKY.",
  • "tracking_id": "111771747633261941E6VT",
  • "booking_id": "HO2622FEIDACKY",
  • "general": {
    • "service_type": "HOTEL",
    • "service_details": "Hotel 1 night(s) Booking Check-In 2026-03-15 and CheckOut 2026-03-16. 2 room(s) with 4 adult(s) 0 child(s)",
    • "booking_remarks": "null,",
    • "generated_date": "2026-02-22",
    • "partner_id": "1",
    • "master_partner_id": "1",
    • "branch_id": "BDHE001",
    • "tracking_id": "111771747633261941E6VT",
    • "booking_id": "HO2622FEIDACKY",
    • "hotel_ref_id": "null,",
    • "supplier_confirmation_id": "6VEW02X8Q5",
    • "supplier_others_id_a": "a7a2fb6a-33b9-4b9b-9d92-cfef08ee34cf",
    • "supplier_others_id_b": "null,",
    • "member_id": "1",
    • "book_by": "NS Nayeem",
    • "ip_address": "null,",
    • "timestamp": "1771748594",
    • "last_update": "1771748594",
    • "supplier_invoice_company": "null,",
    • "supplier_invoice_number": null
    },
  • "voucher": {},
  • "booking": {
    • "status": "success",
    • "booking_status": "confirm",
    • "booking_supplier_status": "confirm",
    • "voucher_status": "issued",
    • "payment_status": "pending",
    • "auto_cancel_status": "pending",
    • "partner_timezone": "Asia/Dhaka",
    • "auto_cancel": "2026-02-22T14:07:13",
    • "auto_cancel_timestamp": "1771747633"
    },
  • "price": {
    • "currency": "BDT",
    • "total_amount": "20028.92",
    • "sell_total_price": "20028.92",
    • "sales_comission": "0"
    },
  • "hotel": {
    • "search_parameter": {
      }
    },
  • "room": {
    • "summery": {
      }
    },
  • "-"data"()": {
    • "room_number": "DOUBLE CLUB QUEEN BED",
    • "name": "DOUBLE CLUB QUEEN BED",
    • "rate_comments": ". Check-in hour 15:00-.Car park YES (Without additional debit notes).Check-out hour -00:00.",
    • "rate_code": "RO",
    • "rate_type": "Room Only",
    • "info": {
      }
    },
  • "occupancies": {
    • "total_room": "1",
    • "adult": null,
    • "child": null
    },
  • "rate_data": {
    • "RoomCode": "fff05113fce24739a9cb3549eb78c043|@KGB1097616@29@e020e4194bc049eaa6c71104e812d246"
    },
  • "-"price"": {
    • "promo_tag": "null,",
    • "purchase": {
      },
    • "sell": {
      },
    • "price_breakdown": {
      },
    • "fmg": {
      },
    • "supplier": {
      },
    • "meal_option": [ ],
    • "bed_option": [ ],
    • "amenities": [ ],
    • "cancellation_raw": [
      ],
    • "cancellation_policy": {
      },
    • "room_number": "DOUBLE CLUB QUEEN BED",
    • "name": "DOUBLE CLUB QUEEN BED",
    • "rate_comments": ". Check-in hour 15:00-.Car park YES (Without additional debit notes).Check-out hour -00:00.",
    • "rate_code": "RO",
    • "rate_type": "Room Only",
    • "info": {
      },
    • "occupancies": {
      },
    • "rate_data": {
      },
    • "price": {
      },
    • "point_of_interests": [
      ],
    • "nearest_airports": "null,",
    • "train_stations": "null,",
    • "connected_locations": "null,",
    • "stadiums": null
    },
  • "pax": {
    • "primary": {
      }
    },
  • "data": [
    • {
      }
    ],
  • "partner": {},
  • "supplier": {
    • "info": {
      },
    • "price": {
      },
    • "terms": {
      },
    • "cancellation_terms": {
      }
    }
}

Get details of a specific booking.

Authorizations:
(apiKeyAuthsecretCodeAuth)
Request Body schema: application/json
required
tracking_id
required
string

Booking tracking ID generated during booking process

booking_id
required
string

Final confirmed hotel booking ID

member_id
required
string

Logged-in user member ID

property name*
additional property
any

Responses

Response Schema: application/json
property name*
additional property
any

Request samples

Content type
application/json
{
  • "tracking_id": "111771747633261941E6VT",
  • "booking_id": "HO2622FEIDACKY",
  • "member_id": "1"
}

Response samples

Content type
application/json
Example
{
  • "status": "string (success/failed)",
  • "reason": "string",
  • "tracking_id": "string",
  • "booking_id": "string",
  • "pay_tracking_id": "string or null",
  • "sendGTMEvent": "boolean",
  • "gateway_trx_id": "string or null",
  • "general": {
    • "service_type": "string",
    • "service_details": "string",
    • "booking_remarks": "string or null",
    • "generated_date": "string (YYYY-MM-DD)",
    • "partner_id": "string/int",
    • "master_partner_id": "string/int",
    • "branch_id": "string",
    • "tracking_id": "string",
    • "booking_id": "string",
    • "hotel_ref_id": "string or null",
    • "supplier_confirmation_id": "string",
    • "supplier_others_id_a": "string (UUID)",
    • "supplier_others_id_b": "null",
    • "member_id": "string",
    • "book_by": "string",
    • "timestamp": "string (Unix Timestamp)",
    • "last_update": "string (Unix Timestamp)",
    • "voucher": {
      }
    },
  • "voucher": {
    • "can_view_download": "string (yes/no)",
    • "link": "string (URL)",
    • "pdf": "string (URL)",
    • "pdf_with_price": "string (URL)",
    • "show_supplier_option": "string (yes/no)",
    • "qr_code": "string (show/hide)"
    },
  • "booking": {
    • "status": "string",
    • "booking_status": "string (confirm/pending/cancel)",
    • "booking_supplier_status": "string",
    • "voucher_status": "string (issued/pending)",
    • "payment_status": "string",
    • "auto_cancel": "string (ISO Date)",
    • "auto_cancel_timestamp": "string (Unix Timestamp)"
    },
  • "price": {
    • "currency": "string (e.g., BDT)",
    • "total_amount": "string/float",
    • "sell_total_price": "string/float",
    • "sales_comission": "string or null",
    • "applied_comission_ratio": "string/int"
    },
  • "hotel": {
    • "search_parameter": {
      },
    • "room": {
      },
    • "hotel_contents": {
      }
    }
}

issue-voucher for booking.

Authorizations:
(apiKeyAuthsecretCodeAuth)
Request Body schema: application/json
required
member_id
required
string

Logged-in user member ID

tracking_id
required
string

Booking or Hotel tracking ID

price_change_accepted
required
string
Enum: "yes" "no"

Whether the price change is accepted ("yes" or "no")

notes
string or null

Additional notes (optional)

property name*
additional property
any

Responses

Response Schema: application/json
property name*
additional property
any

Request samples

Content type
application/json
{
  • "member_id": "1",
  • "tracking_id": "11177251811403210FPDT2",
  • "price_change_accepted": "no",
  • "notes": "not required"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "reason": "The booking has been successfully Issue voucher",
  • "reason_admin": "null,",
  • "tracking_id": "11177251811403210FPDT2",
  • "booking_status": "confirm",
  • "pax_ticket_data": "null,",
  • "supplier_confirmation_id": "null,",
  • "past_booking_details": {
    • "last_update": "1772518220",
    • "tracking_id": "11177251811403210FPDT2",
    • "booking_id": "HO2603MA6SACYB",
    • "supplier_confirmation_id": "370036221",
    • "airlines_pnr": "null,",
    • "service_type": "HOTEL",
    • "status": "confirm",
    • "booking_status": "confirm",
    • "generated_date": "2026-03-03"
    },
  • "Execute_Data": {
    • "status": "success",
    • "booking_status": "confirm",
    • "reason": "The booking has been successfully Issue voucher",
    • "booking_supplier_status": "ok"
    }
}

Cancel hotel booking.

Authorizations:
(apiKeyAuthsecretCodeAuth)
Request Body schema: application/json
required
member_id
required
string

Logged-in user member ID

tracking_id
required
string

Booking or Hotel tracking ID

reason
string or null

Reason for cancellation (optional)

property name*
additional property
any

Responses

Response Schema: application/json
property name*
additional property
any

Request samples

Content type
application/json
{
  • "member_id": "1",
  • "tracking_id": "11177251811403210FPDT2",
  • "reason": "not required"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "reason": "The booking has been successfully canceled.. Refund ref id. ITT-RFD-030326-0052 request for BDT 490.36 has been successfully submitted. The finance team will proceed to verify and update accordingly.",
  • "reason_admin": "null,",
  • "tracking_id": "11177251811403210FPDT2",
  • "booking_id": "HO2603MA6SACYB",
  • "booking_status": "cancel",
  • "booking_supplier_status": "cancel",
  • "cancellationReference": "null,",
  • "post_booking_details": {
    • "last_update": "1772518476",
    • "tracking_id": "11177251811403210FPDT2",
    • "booking_id": "HO2603MA6SACYB",
    • "supplier_confirmation_id": "370036221",
    • "airlines_pnr": null,
    • "service_type": "HOTEL",
    • "status": "cancel",
    • "booking_status": "cancel",
    • "generated_date": "2026-03-03"
    }
}
←Back to Portal