API docs by Redocly

ITT Activity API (1.0.0)

Download OpenAPI specification:

Activity API endpoints converted from Postman collection.

Activity

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

Activity Service

Search for sightseeing and activities

Search for available tours, sightseeing activities, and experiences based on location, dates, and traveler information.

Authorizations:
(apiKeyAuthsecretCodeAuth)
Request Body schema: application/json
required
required
Array of objects

Search locations. Multiple locations can be sent for complex searches.
travelers_adult
required
integer

Number of adult travelers.
travelers_child
integer

Number of child travelers.
travelers_child_age
Array of integers

Ages of child travelers.
travelers_infants
integer
travelers_infants_age
Array of integers
from
required
string <date>

Activity start date (YYYY-MM-DD).
to
required
string <date>

Activity end date (YYYY-MM-DD).
supplier_uid
string

Unique ID of the supplier. Use 'all' or specific ID.

partner_id
string

Partner identifier, can be left blank if not applicable.
short_ref
string

Reference for stream search tracking.
order
string
Enum: "DEFAULT" "PRICE" "NAME"

Sorting order of the search results.
language
required
string

Preferred language for results (e.g., en, bn).

Responses

Request samples

Content type
application/json
{
  • "segment": [
    ],
  • "travelers_adult": 1,
  • "travelers_child": 0,
  • "travelers_child_age": [ ],
  • "travelers_infants": 0,
  • "travelers_infants_age": [ ],
  • "from": "2025-05-28",
  • "to": "2025-05-30",
  • "supplier_uid": "X1HS00024",
  • "partner_id": "",
  • "short_ref": "xxxx111",
  • "order": "DEFAULT",
  • "language": "en"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "total_transfer_found": 12,
  • "data": [
    ]
}

Search for a single specific activity details

Retrieve detailed availability and pricing for a specific activity using its unique activity ID.

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

The unique identifier for the activity (includes supplier and hash data).
travelers_adult
required
integer

Total number of adult travelers.
travelers_child
integer

Total number of child travelers.
travelers_infants
integer

Total number of infant travelers.
travelers_child_age
Array of integers

Ages of child travelers in an array.
travelers_infants_age
Array of integers

Ages of infant travelers in an array.
from
required
string <date>

Start date of the activity (YYYY-MM-DD).
to
required
string <date>

End date of the activity (YYYY-MM-DD).
order
string
Enum: "DEFAULT" "PRICE" "NAME"

Sorting preference for the response.
language
required
string

Response language code (e.g., en, fr).
guest_nationality
required
string

ISO 2-letter country code of the guest's nationality.

Responses

Request samples

Content type
application/json
{
  • "activity_id": "X1TY00043#T66-1205-22924#614b68c0-d862-422f-a6ca-7dd3ad15c84d",
  • "travelers_adult": 3,
  • "travelers_child": 1,
  • "travelers_infants": 0,
  • "travelers_child_age": [
    ],
  • "travelers_infants_age": [ ],
  • "from": "2026-02-28",
  • "to": "2026-03-01",
  • "order": "DEFAULT",
  • "language": "en",
  • "guest_nationality": "BD"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "tracking_id": "11174210385626193VXCML",
  • "search_parameter": {
    },
  • "session_expire": {
    },
  • "data": {
    }
}

Get validated activity details

Retrieve information about a previously validated activity using the tracking IDs and member identifier.

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

The main search tracking ID.
package_tracking_id
required
string

The specific rate UID or package tracking ID for the selected activity.
member_id
required
string

Unique ID of the member. For B2C, this is mandatory.

Responses

Request samples

Content type
application/json
{
  • "tracking_id": "311177598415126194HNY4Y",
  • "package_tracking_id": "311177598415126194HNY4Y||E-E10-A9SUNO0012||X1HS00024||0",
  • "member_id": "1"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "tracking_id": "311177598415126194HNY4Y",
  • "search_parameter": {
    },
  • "session_expire": {
    },
  • "data": {
    }
}

Update traveler information for an activity booking

This endpoint allows updating the details of passengers (travelers) associated with a specific activity tracking ID before final confirmation.

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

The booking tracking ID received from the Validation step.

member_id
required
string

The unique ID of the logged-in member/user.
save_pax
string
Enum: "yes" "no"

Option to save passenger data for future use. Default is 'no'.
required
Array of objects

List of passengers/travelers details.

Responses

Request samples

Content type
application/json
{
  • "tracking_id": "311177598415126194HNY4Y",
  • "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": "311177598415126194HNY4Y",
  • "total_guest": 1,
  • "data": [
    ]
}

Create a final activity booking

This endpoint confirms the booking for the selected activity and processes the payment.

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

The unique search tracking ID.
package_tracking_id
required
string

The specific rate or package tracking ID (Rate UID).
rate_key
string

Unique rate key provided by some suppliers (Optional).
member_id
required
string

The unique ID of the logged-in member/user.
isd_code
string

Country dial code without the plus sign.
nationality
string

ISO 2-letter country code of the lead guest.
contact_no
string

Contact mobile number.
email_address
required
string <email>

Email address for booking confirmation and vouchers.
payment_type
required
string
Enum: "account_balance" "card" "onlinepayment"

Method of payment.
isPartialPay
required
string
Enum: "yes" "no"

Whether the user is opting for partial payment.
redirect_url
string

URL to redirect the user after successful payment (Mandatory for card/onlinepayment).
Array of objects

Additional questions required by the activity supplier (if any).

Responses

Request samples

Content type
application/json
{
  • "tracking_id": "11177012245288128VWKDN",
  • "package_tracking_id": "11177012245288128VWKDN||T66-1198-14856||X1TY00043||0||HcO7DYAwDAXAhbDkX5xkASagRwFMhWho3_AIdLolgkR6I_FWAlDWYGUDT_jqyiv4lzfmcT1JAKoVPg-rlGZKXninbT-Fhg3N5i4lA-r9BQ",
  • "rate_key": "ud3v6vpg4hmsrgvsl56btfd5av0819",
  • "member_id": "1",
  • "isd_code": "880",
  • "nationality": "BD",
  • "contact_no": "1966330000",
  • "email_address": "[email protected]",
  • "payment_type": "account_balance",
  • "isPartialPay": "no",
  • "redirect_url": "https://ittsabbir.example.com/booking-details/activities",
  • "questions": [ ]
}

Response samples

Content type
application/json
Example
{
  • "operationId": "8dd4d02ec8ca5931",
  • "auditData": {
    },
  • "booking": {
    }
}

Cancel an existing activity booking

This endpoint allows users to cancel a booked activity using the tracking ID and providing a specific reason.

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

The unique ID of the member who made the booking.
tracking_id
required
string

The unique tracking ID or booking reference ID of the activity.
reason
required
string

Brief explanation for the cancellation.

Responses

Request samples

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

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "message": "Your cancellation request has been processed successfully.",
  • "refund_amount": 12000,
  • "currency": "BDT",
  • "cancellation_charge": 500,
  • "tracking_id": "11176171377026194RX2KZ"
}

Get booking details

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

Logged-in user member ID
tracking_id
required
string

eSIM or booking tracking ID
booking_id
required
string

Booking ID for the eSIM package
property name*
additional property
any

Responses

Request samples

Content type
application/json
{
  • "member_id": "2",
  • "tracking_id": "11176276126126194RHSGI",
  • "booking_id": "ES2510NOKJAAFK"
}

Response samples

Content type
application/json
{ }
← Back to Portal