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.

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.

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.

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.

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

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": "test@example.com",
  • "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": {
    • "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"
}

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

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

Request samples

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

Response samples

Content type
application/json
{ }
←Back to Portal