API docs by Redocly

ITTActivity 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.

from
required
string <date>

Activity start date (YYYY-MM-DD).

to
required
string <date>

Activity end date (YYYY-MM-DD).

language
required
string

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

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
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.

Responses

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

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.

from
required
string <date>

Start date of the activity (YYYY-MM-DD).

to
required
string <date>

End date of the activity (YYYY-MM-DD).

language
required
string

Response language code (e.g., en, fr).

guest_nationality
required
string

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

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.

order
string
Enum: "DEFAULT" "PRICE" "NAME"

Sorting preference for the response.

Responses

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

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": [
    • 5
    ],
  • "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": {
    • "activity_id": "X1HS00278#E-E10-A0PPNO0027",
    • "travelers_adult": 4,
    • "travelers_child": 2,
    • "travelers_child_age": [
      ],
    • "travelers_infants": 0,
    • "travelers_infants_age": [ ],
    • "from": "2025-05-28",
    • "to": "2025-05-29",
    • "order": "DEFAULT",
    • "language": "en",
    • "activity_code": "E-E10-A0PPNO0027",
    • "supplier_title": "Activity HotelBeds",
    • "supplier_type": "ACTIVITY",
    • "supplier_code": "activity-hotelbeds",
    • "supplier_uid": "X1HS00278",
    • "supplier_partner_code": "activity-hotelbeds-1-00278"
    },
  • "session_expire": {
    • "timestamp": 1742104397,
    • "datetime": "2025-03-16 11:53:17 +06",
    • "message": "The booking process should be completed by no later than 2025-03-16 11:53:17 +06."
    },
  • "data": {
    • "total_packages": 3,
    • "connected_all_supplier": "",
    • "create_connected_supplier": "",
    • "activity": {
      }
    }
}

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

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

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": {
    • "activity_id": "X1HS00024#E-E10-A9SUNO0012",
    • "travelers_adult": 1,
    • "travelers_child": 1,
    • "travelers_infants": 0,
    • "travelers_child_age": [
      ],
    • "travelers_infants_age": [ ],
    • "from": "2026-04-28",
    • "to": "2026-05-10",
    • "order": "DEFAULT",
    • "language": "en",
    • "guest_nationality": "BD",
    • "activity_code": "E-E10-A9SUNO0012",
    • "result_token": null,
    • "supplier_title": "HotelBeds Activity",
    • "supplier_type": "ACTIVITY",
    • "supplier_code": "activity-hotelbeds",
    • "supplier_uid": "X1HS00024",
    • "supplier_partner_code": "activity-hotelbeds-1-00024",
    • "package_tracking_id": "311177598415126194HNY4Y||E-E10-A9SUNO0012||X1HS00024||0"
    },
  • "session_expire": {
    • "timestamp": 1775984693,
    • "datetime": "2026-04-12 15:04:53 +06",
    • "message": "The booking process should be completed by no later than 2026-04-12 15:04:53 +06."
    },
  • "data": {
    • "package_tracking_id": "311177598415126194HNY4Y||E-E10-A9SUNO0012||X1HS00024||0",
    • "name": "Dubai Helicopter Private Tour with Return Transfers",
    • "package_name": "Iconic Tour - 12 Minutes",
    • "duration": "1 DAYS",
    • "total_pax": 2,
    • "total_amount": 202406.92,
    • "platform_fees_or_extra_tax": 0,
    • "amount_currency": "BDT",
    • "price": {
      },
    • "questions": [
      ],
    • "comments": [
      ],
    • "rate_variation": [ ],
    • "supplier_name": "HOTELBEDS SPAIN, S.L.U",
    • "supplier_vat_number": "ESB28916765",
    • "provider_name": "HELIDUBAI"
    }
}

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.

required
Array of objects

List of passengers/travelers details.

save_pax
string
Enum: "yes" "no"

Option to save passenger data for future use. Default is 'no'.

Responses

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

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).

member_id
required
string

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

isPartialPay
required
string
Enum: "yes" "no"

Whether the user is opting for partial payment.

email_address
required
string <email>

Email address for booking confirmation and vouchers.

rate_key
string

Unique rate key provided by some suppliers (Optional).

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.

Array of objects

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

Responses

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

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]",
  • "isPartialPay": "no",
  • "questions": [ ]
}

Response samples

Content type
application/json
Example
{
  • "operationId": "8dd4d02ec8ca5931",
  • "auditData": {
    • "processTime": 1.099,
    • "time": "2025-03-17T09:35:25.196Z",
    • "serverId": "blank",
    • "environment": "blank"
    },
  • "booking": {
    • "reference": "1-7897553",
    • "status": "CONFIRMED",
    • "currency": "EUR",
    • "pendingAmount": 190.04,
    • "agency": {
      },
    • "creationDate": "2025-03-17T10:35:24.000Z",
    • "paymentData": {
      },
    • "extraData": [
      ],
    • "clientReference": "NS2517MAAA32",
    • "holder": {
      },
    • "total": 190.04,
    • "totalNet": 190.04,
    • "activities": [
      ]
    }
}

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

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

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

General - Bookings

Get Booking List

Retrieve a filtered list of bookings using search parameters like service type, date ranges, PNR, and guest info.

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

Unique user login member ID

tracking_id
required
string

Booking tracking identifier

booking_id
required
string

Unique booking ID

supplier_confirmation_id
required
string

Supplier confirmation reference number

airlines_pnr
required
string

Airline PNR code

service_type
required
string
Enum: "FLIGHT" "HOTEL" "TRANSFER" "CAR" "CRUISE" "SIGHTSEEING" "RAIL"

Service type classification

generated_date_start
required
string <date>

Start date for generation filter (YYYY-MM-DD)

generated_date_end
required
string <date>

End date for generation filter (YYYY-MM-DD)

book_date_start
required
string

Booking start date filter

book_date_end
required
string

Booking end date filter

primary_guest_name
required
string

Primary guest name

primary_guest_contact_no
required
string

Primary guest contact number

limit_data
required
string

Limit for the number of records returned

Responses

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

Request samples

Content type
application/json
{
  • "member_id": "1",
  • "tracking_id": "",
  • "booking_id": "",
  • "supplier_confirmation_id": "",
  • "airlines_pnr": "",
  • "service_type": "FLIGHT",
  • "generated_date_start": "2024-01-01",
  • "generated_date_end": "2025-12-12",
  • "book_date_start": "",
  • "book_date_end": "",
  • "primary_guest_name": "",
  • "primary_guest_contact_no": "",
  • "limit_data": "50"
}

Response samples

Content type
application/json
{}

Get Booking Details

Retrieve complete details for a specific booking using member ID and tracking ID.

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

Unique user login member ID

tracking_id
required
string

Unique booking tracking ID

Responses

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

Request samples

Content type
application/json
{
  • "member_id": "1",
  • "tracking_id": "11174652205711744PS4CQ"
}

Response samples

Content type
application/json
{
  • "status": "success",
  • "reason": "Booking Details",
  • "tracking_id": "311178539625080180EG2PP",
  • "booking_id": "FT2630JL5XA4KZ",
  • "pay_tracking_id": null,
  • "sendGTMEvent": false,
  • "general": {
    • "booking_platform": "B2B",
    • "service_type": "FASTTRACK",
    • "service_details": "Fast Track “Fast Track” booked with 1 Adult(s), 0 Child(s), 0 Infant(s)",
    • "booking_remarks": null,
    • "generated_date": "2026-07-30",
    • "partner_id": "31",
    • "master_partner_id": "1",
    • "branch_id": "BDHE001",
    • "IsCardPayBooking": "no",
    • "CardPayStatus": "pending",
    • "CardPayBookingStatus": "processing",
    • "CardPayBookingStatusExecute": "pending",
    • "CardPayBookingJSON": null,
    • "tracking_id": "311178539625080180EG2PP",
    • "booking_id": "FT2630JL5XA4KZ",
    • "supplier_confirmation_id": "1e840683-e401-44a8-8c52-ebe92dfbcf3b",
    • "supplier_others_id_a": "AO260730000012",
    • "supplier_others_id_b": "799f6a0b-521c-4fbc-b43c-afa17bf68143",
    • "name": "Fast Track “Fast Track”",
    • "airside": false,
    • "terminal": "Terminal 3",
    • "booking_cutoff_hours": "0",
    • "cancellation_cutoff_hours": "6",
    • "airport_iata": "DXB",
    • "flight_number": "ASDFAS",
    • "booking_date": "2026-08-30",
    • "booking_time": "08:00:00",
    • "member_id": "2",
    • "book_by": null,
    • "ip_address": "43.250.80.180",
    • "timestamp": "1785396270",
    • "last_update": "1785396270",
    • "supplier_invoice_company": null,
    • "supplier_invoice_number": null,
    • "voucher": {
      }
    },
  • "fullfillment": [
    • {
      }
    ],
  • "businessLounge": {
    • "data": null
    },
  • "voucher": {},
  • "booking": {
    • "status": "success",
    • "booking_status": "confirm",
    • "booking_supplier_status": "Completed",
    • "voucher_status": "issued",
    • "payment_status": "pending",
    • "auto_cancel_status": "pending",
    • "auto_cancel": "2026-07-30 23:59:59",
    • "auto_cancel_timestamp": "1785434399",
    • "special_requests_data": null,
    • "show_hold_booking_time_limit": "yes",
    • "show_hold_booking_time_limit_msg": ""
    },
  • "price": {
    • "currency": "BDT",
    • "total_amount": "2127.55",
    • "sell_total_price": "2127.55",
    • "sales_comission": null,
    • "applied_comission_ratio": "0",
    • "customer_markup_policy": null
    },
  • "pax": {
    • "primary": {
      },
    • "data": [
      ]
    },
  • "invoice_data": [
    • {
      }
    ],
  • "refund_status_list": [
    • "requested",
    • "processing",
    • "refunded"
    ],
  • "refund_data": [ ],
  • "partner": {},
  • "supplier": {
    • "info": {
      }
    },
  • "terms": {
    • "status": "disable",
    • "text": ""
    },
  • "cancellation_terms": {
    • "status": "disable",
    • "text": ""
    },
  • "special_notice_status": "disable",
  • "special_notice": null
}
←Back to Portal