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

Request samples

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

Response samples

Content type
application/json
Example
[
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

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

guest_nationality
string

Nationality of the guest (ISO country code)

supplier_uid
string

Supplier unique ID (optional)

checkIn
required
string <date>

Check-in date (YYYY-MM-DD)

checkOut
required
string <date>

Check-out date (YYYY-MM-DD)

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)

required
object
property name*
additional property
any

Responses

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": {
    },
  • "data": {
    }
}

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

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": {
    },
  • "session_expire": {
    },
  • "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

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": {
    }
}

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

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": {
    },
  • "validation_price": {
    },
  • "session_expire": {
    },
  • "search_parameter": {
    },
  • "data": {
    },
  • "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

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": {
    },
  • "validation_price": {
    },
  • "session_expire": {
    },
  • "search_parameter": {
    },
  • "guest_data": [ ],
  • "hotel_contents": {
    }
}

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

save_pax
string

Save passenger details for future bookings (yes / no)

required
Array of objects

List of passengers for hotel booking

property name*
additional property
any

Responses

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

room_tracking_id
string

Selected room tracking ID (if applicable)

isd_code
string

ISD code for customer contact number

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)

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

member_id
required
string

Logged-in member account ID

special_requests_notes
string

Additional special requests or notes for the booking

property name*
additional property
any

Responses

Request samples

Content type
application/json
{
  • "tracking_id": 11175108883326192,
  • "room_tracking_id": "11175108883326193VKD98-H1AS00029-0",
  • "isd_code": "1",
  • "contact_no": "01700000000",
  • "email_address": "[email protected]",
  • "payment_type": "account_balance",
  • "agency_isd_code": "1",
  • "agency_contact_no": "01700000000",
  • "agency_email": "[email protected]",
  • "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": {
    },
  • "booking": {
    },
  • "price": {
    },
  • "hotel": {
    },
  • "room": {
    },
  • "-"data"()": {
    },
  • "occupancies": {
    },
  • "rate_data": {
    },
  • "-"price"": {
    },
  • "pax": {
    },
  • "data": [
    ],
  • "partner": {},
  • "supplier": {
    }
}

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

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": {
    },
  • "voucher": {
    },
  • "booking": {
    },
  • "price": {
    },
  • "hotel": {
    }
}

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

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": {
    },
  • "Execute_Data": {
    }
}

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

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": {
    }
}
Back to Portal