ITT Tour Package API (1.0.0)

Download OpenAPI specification:

Tour Package API endpoints converted from Postman collection.

Tour Service

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

Get city suggestions for tours

Retrieves a list of cities based on the country code. If the country_code is left empty (null/empty string), it returns suggestions for all available countries.

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

ISO country code (e.g., 'TH', 'AE'). Set as an empty string to get suggestions for all countries.

Responses

Request samples

Content type
application/json
{
  • "country_code": ""
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "reason": "10 city available",
  • "data": [
    ]
}

Search for available tours

Search for tours based on country, city, category, or specific tour name. Leave fields empty (null string) to broaden the search results.

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

ISO country code (e.g., TH, AE). Set empty for all countries.

city_code
string

City name or code (e.g., Dubai, Dhaka). Set empty for all cities.

tour_category_code
string

Category of the tour (e.g., luxury, family). Set empty for all categories.

tour_name
string

Specific name of the tour or service. Set empty for all.

tour_date
required
string <date>

The date of the tour (YYYY-MM-DD).

Responses

Request samples

Content type
application/json
{
  • "country_code": "",
  • "city_code": "",
  • "tour_category_code": "",
  • "tour_name": "",
  • "tour_date": "2026-06-20"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "reason": "3 tour service available",
  • "search_date": "2026-02-20",
  • "data": [
    ],
  • "offers": [ ]
}

Get tour details

Retrieves comprehensive information about a specific tour package using its SEO-friendly code.

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

The SEO-friendly unique string identifier for the tour.

Responses

Request samples

Content type
application/json
{
  • "tour_seo_code": "dubai-3-nights-4-days-tour-package"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "reason": "Selected tour service available",
  • "data": {
    },
  • "itinerary_data": [
    ],
  • "hotel_data": [
    ],
  • "transfer_data": null,
  • "flight_data": null,
  • "activity_data": null,
  • "insurance_data": null,
  • "meal_data": null,
  • "guide_data": null,
  • "offers": [ ]
}

Validate tour selection and options

Validates the selected tour package along with its components like hotels, transfers, flights, and other add-ons for a specific date and passenger count.

Authorizations:
(apiKeyAuthsecretCodeAuth)
Request Body schema: application/json
required
tour_seo_code
required
string
adult
required
string
child
string
infant
string
hotel_data
Array of strings
transfer_data
Array of strings
flight_data
Array of strings
insurance_data
Array of strings
activity_data
Array of strings
meal_data
Array of strings
guide
Array of strings
checkIn
required
string <date>
extra_bed
required
string
Enum: "yes" "no"

Specify if an extra bed is required.

extra_bed_amount
string

The number of extra beds (Required if extra_bed is 'yes').

Responses

Request samples

Content type
application/json
{
  • "tour_seo_code": "dubai-3-nights-4-days-tour-package",
  • "adult": "2",
  • "child": "0",
  • "infant": "0",
  • "hotel_data": [
    ],
  • "transfer_data": [
    ],
  • "flight_data": [
    ],
  • "insurance_data": [
    ],
  • "activity_data": [
    ],
  • "meal_data": [
    ],
  • "guide": [
    ],
  • "checkIn": "2026-06-09",
  • "extra_bed": "no",
  • "extra_bed_amount": "2"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "tracking_id": "31177718803526194Z77UX",
  • "session_expire": {
    },
  • "search_parameter": {
    },
  • "data": {
    },
  • "offers": [ ]
}

Get tour validation details

Retrieves the detailed summary of the validated tour package using the tracking ID.

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

The unique tracking ID obtained from the /tour/validate response.

Responses

Request samples

Content type
application/json
{
  • "tracking_id": "31177718803526194Z77UX"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "tracking_id": "31177718803526194Z77UX",
  • "session_expire": {
    },
  • "search_parameter": {
    },
  • "data": {
    },
  • "offers": [ ],
  • "guest_data": [ ]
}

Update traveller information for tour

Updates the passenger details for a tour booking using the tracking ID.

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

The unique tracking ID from the validation step.

member_id
string

ID of the logged-in member.

save_pax
string
Enum: "yes" "no"

Whether to save the passenger data for future use.

required
Array of objects

Responses

Request samples

Content type
application/json
{
  • "tracking_id": "31177718803526194Z77UX",
  • "member_id": "1",
  • "save_pax": "no",
  • "passenger": [
    ]
}

Response samples

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

Confirm tour booking and place order

Finalizes the tour booking process. If the payment_type is 'card', the redirect_url is used for payment processing.

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

The unique tracking ID for the booking.

member_id
string

ID of the logged-in member.

isd_code
string
contact_no
string
email_address
string <email>
payment_type
required
string
Enum: "account_balance" "card"

Payment method (account_balance or card).

redirect_url
required
string <uri>

Required if payment_type is 'card'.

special_requests_notes
string
agency_isd_code
string
agency_contact_no
string
agency_email
string <email>

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "result": "OK",
  • "reason": "Order created successfully. Please contact the agency for service",
  • "tracking_id": "1177728730503210LCAKM",
  • "booking_id": "TO2627APVEA3PP",
  • "data": {
    }
}

Get tour order details

Retrieves the complete information, status, and summary of a confirmed tour booking using the tracking ID and booking ID.

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

The unique tracking ID associated with the booking process.

booking_id
required
string

The final booking reference ID generated after a successful order.

Responses

Request samples

Content type
application/json
{
  • "tracking_id": "1175160241551208JLFCS",
  • "booking_id": "NS2504JLC7AABY"
}

Response samples

Content type
application/json
Example
{
  • "status": "confirm",
  • "reason": "Booking Details",
  • "tracking_id": "1177728730503210LCAKM",
  • "booking_id": "TO2627APVEA3PP",
  • "pay_tracking_id": null,
  • "sendGTMEvent": false,
  • "general": {
    },
  • "booking": {
    },
  • "price": {
    },
  • "tour": {
    },
  • "pax": {
    },
  • "invoice_data": [
    ],
  • "refund_status_list": [
    ],
  • "refund_data": [ ],
  • "partner": {
    },
  • "supplier": null,
  • "terms": {
    },
  • "cancellation_terms": {
    },
  • "special_notice_status": null,
  • "special_notice": null
}

Issue a tour order

Finalizes the ticket/voucher issuance process. If there is a price fluctuation, the user must explicitly accept it via the 'price_change_accepted' field.

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

The unique ID of the logged-in member.

tracking_id
required
string

The unique tracking ID for the booking.

price_change_accepted
required
string
Enum: "yes" "no"

Whether the user accepts a potential price change during issuance.

notes
string

Any additional notes for the issuance process.

Responses

Request samples

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

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "reason": "The booking has been successfully Issue Booking",
  • "reason_admin": null,
  • "tracking_id": "1177728730503210LCAKM",
  • "booking_status": "confirm",
  • "past_booking_details": {
    },
  • "Data": {
    }
}
Back to Portal