API docs by Redocly

ITTTransfer API (1.0.0)

Download OpenAPI specification:

Transfer API endpoints converted from Postman collection.

Transfer

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

Search for transfers.

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

List of transfer route segments

property name*
additional property
any

Responses

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

Request samples

Content type
application/json
{
  • "segment": [
    • {
      }
    ],
  • "journey_type": "OneWay",
  • "travelers_adult": 2,
  • "travelers_adult_types": [
    • ""
    ],
  • "travelers_child": 0,
  • "travelers_child_types": [ ],
  • "travelers_child_age": [ ],
  • "travelers_infants": 0,
  • "travelers_infants_age": [ ],
  • "travelers_infants_types": [ ],
  • "guest_nationality": "BD",
  • "transfer_type": "private",
  • "supplier_uid": "all",
  • "partner_id": "",
  • "short_ref": "xxxx111",
  • "language": "en",
  • "service_type": "regular"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "reason": "Your destination search yielded results for 15 transfers.",
  • "tracking_id": "117728706608V21",
  • "search_parameter": {
    • "segment": {
      },
    • "journey_type": "OneWay",
    • "travelers_adult": "2,",
    • "travelers_adult_types": [
      ],
    • "travelers_child": "0,",
    • "travelers_child_types": [ ],
    • "travelers_child_age": [ ],
    • "travelers_infants": "0,",
    • "travelers_infants_age": [ ],
    • "travelers_infants_types": [ ],
    • "guest_nationality": "BD",
    • "transfer_type": "private",
    • "supplier_uid": "all",
    • "partner_id": "",
    • "short_ref": "xxxx111",
    • "language": "en",
    • "service_type": "regular",
    • "country_code": "AE",
    • "tracking_id": "117728706608V21",
    • "total_transfer": "15,",
    • "transfer_data": {
      }
    }
}

Search for Single transfers.

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

Unique tracking ID from transfer search response

transfer_id
required
string

Unique transfer identifier

property name*
additional property
any

Responses

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

Request samples

Content type
application/json
{
  • "tracking_id": "11772862765YXW1",
  • "transfer_id": "T1HS00025#0-43"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "tracking_id": "111772863275261949XMKY",
  • "search_parameter": {
    • "segment": {
      },
    • "journey_type": "OneWay",
    • "travelers_adult": "2,",
    • "travelers_adult_types": [
      ],
    • "travelers_child": "0,",
    • "travelers_child_types": [ ],
    • "travelers_child_age": [ ],
    • "travelers_infants": "0,",
    • "travelers_infants_age": [ ],
    • "travelers_infants_types": [ ],
    • "guest_nationality": "BD",
    • "transfer_type": "private",
    • "supplier_uid": "T1HS00025",
    • "partner_id": "",
    • "short_ref": "xxxx111",
    • "language": "en",
    • "service_type": "regular",
    • "country_code": "AE",
    • "tracking_id": "11772862765YXW1",
    • "supplier_type": "TRANSFER",
    • "supplier_code": "transfer-hotelbeds",
    • "supplier_partner_code": "transfer-hotelbeds-1-00025"
    },
  • "session_expire": "null,",
  • "transfer_data": {
    • "tracking_id": "111772863275261949XMKY",
    • "transfer_tracking_id": "111772863275261949XMKY||0-43",
    • "transfer_id": "T1HS00025#0-43",
    • "transfer_supplier": "hotelbeds",
    • "sell_total": "3252.73,",
    • "sell_currency": "BDT",
    • "transfer_type": "PRIVATE",
    • "transfer_vehicle": "Car",
    • "transfer_category": "Standard",
    • "transfer_baggage": "3 suitcases permitted",
    • "data": {
      },
    • "price": {
      }
    }
}

Update traveler information for existing transfers.

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

Booking tracking ID from validation

member_id
required
string

Logged-in user member ID

required
Array of objects

List of passenger details

save_pax
string

Save passenger information for future use (yes / no)

property name*
additional property
any

Responses

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

Request samples

Content type
application/json
{
  • "booking_tracking_id": "111772863275261949XMKY",
  • "member_id": "2",
  • "save_pax": "yes",
  • "passenger": [
    • {
      },
    • {
      }
    ]
}

Response samples

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

Transfer Booking

Search for Create Booking.

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

Booking tracking ID from validation

transfer_tracking_id
required
string

Transfer tracking ID with segment reference

member_id
required
string

Logged-in user member ID

isd_code
required
string

Country ISD code

contact_no
required
string

Contact number

email_address
required
string

Customer email address

isPartialPay
string

Indicates partial payment (yes / no)

note
string

Optional note for driver

agency_email
string

Agency email (optional)

Array of objects

Linked travel segments (optional)

property name*
additional property
any

Responses

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

Request samples

Content type
application/json
{
  • "booking_tracking_id": "11177303486226194YSHFB",
  • "transfer_tracking_id": "11177303486226194YSHFB||0-43",
  • "member_id": "1",
  • "isPartialPay": "no",
  • "note": "Note to driver",
  • "isd_code": "880",
  • "contact_no": "1966330000",
  • "email_address": "examplesaaqeb.com",
  • "agency_email": "examplesaaqeb.com",
  • "connected_segment": [
    • {
      }
    ]
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "reason": "The booking has been successfully created, and it is associated with the Booking Id TR2609MATDA33W.",
  • "tracking_id": "11177303486226194YSHFB",
  • "booking_id": "TR2609MATDA33W",
  • "general": {
    • "service_type": "TRANSFER",
    • "service_details": "Transfer Booked in 2026-03-30 with 2 adult(s) 0 child(s)",
    • "booking_remarks": null,
    • "generated_date": "2026-03-09",
    • "partner_id": "1",
    • "master_partner_id": "1",
    • "branch_id": "BDHE001",
    • "tracking_id": "11177303486226194YSHFB",
    • "booking_id": "TR2609MATDA33W",
    • "supplier_confirmation_id": "148-6021065",
    • "supplier_others_id_a": null,
    • "supplier_others_id_b": null,
    • "member_id": "1",
    • "book_by": "NS Nayeem",
    • "ip_address": "203.76.126.194",
    • "timestamp": "1773035547",
    • "last_update": "1773035547",
    • "supplier_invoice_company": null,
    • "supplier_invoice_number": null
    },
  • "voucher": {},
  • "booking": {
    • "status": "success",
    • "booking_status": "confirm",
    • "booking_supplier_status": "confirm",
    • "voucher_status": "issued",
    • "payment_status": "pending",
    • "auto_cancel_status": "pending",
    • "auto_cancel": "2026-03-09 23:59:59",
    • "auto_cancel_timestamp": "1773079199"
    },
  • "price": {
    • "currency": "BDT",
    • "total_amount": "3335.33",
    • "sell_total_price": "3335.33",
    • "sales_comission": "0"
    },
  • "transfer": {
    • "search_parameter": {
      },
    • "connected_segment": [
      ],
    • "transfer_data": {
      },
    • "dropoff": {
      },
    • "vehicle": {},
    • "price": {
      },
    • "supplier": {
      },
    • "remarks": [
      ],
    • "additional_services": "null,",
    • "check_pickup": {
      },
    • "supplier_info": {
      }
    },
  • "data": {
    • "Id": "8002",
    • "timestamp": "1773035487",
    • "last_update": "1773035547",
    • "entry": "2",
    • "entry_n": "Nasif Kabir",
    • "ftm_partner_id": "1",
    • "master_partner_id": "null,",
    • "tracking_id": "11177303486226194YSHFB",
    • "service_type": "TRANSFER",
    • "room_number": "1",
    • "pax_id": "1",
    • "passenger_id": "null,",
    • "supplier_pax_id": "null,",
    • "pax_type": "ADT",
    • "paxType_Identity": "null,",
    • "primary_ptc": "null,",
    • "ptc_title": "null,",
    • "gender": "null,",
    • "title": "MR",
    • "first_name": "JASIM",
    • "last_name": "KALAM",
    • "dob": "null,",
    • "pax_age": "30",
    • "nationality": "null,",
    • "doc_type": "null,",
    • "doc_country": "null,",
    • "doc_no": "null,",
    • "cnic": "null,",
    • "doc_dateofexpiry": "2033-12-31",
    • "doc_dateofissue": "2022-12-31",
    • "frequent_flyer_airlines": "null,",
    • "frequent_flyer": "null,",
    • "purpose_of_visit": "null,",
    • "special_request": "null,",
    • "residential_address": "null,",
    • "wheelchair_required": "null,",
    • "isd_code": "880",
    • "contact_no": "1966330000",
    • "email_address": "examplesaaqeb.com",
    • "doc_pics": "null,",
    • "seat_number": "null,",
    • "baggage_option": "null,",
    • "meal_option": "null,",
    • "booking_id": "null,",
    • "ticket_number": "null,",
    • "ticket_status": "null,",
    • "ticket_issueTimeStamp": "null,",
    • "ticket_supplier_status": "null,",
    • "ticket_status_title": "null,",
    • "tktNumberValidation": "0",
    • "comission_type": "null,",
    • "comission_value": "0.00",
    • "currency": "BDT",
    • "sell_total": "0.00",
    • "sell_base_fare": "0.00",
    • "sell_tax": "0.00",
    • "sell_discount": "0.00",
    • "sell_ait": "0",
    • "sell_service_charge": "0.00",
    • "sell_gross_base_fare": "0.00",
    • "sell_gross_tax": "0.00",
    • "cus_ticket_issue_charge": "0",
    • "price_total": "1667.67",
    • "price_base_fare": "0.00",
    • "price_tax": "0.00",
    • "price_taxBreakdown_UT": "0.00",
    • "price_taxBreakdown_E5": "0.00",
    • "price_taxBreakdown_YQ": "0.00",
    • "price_taxBreakdown_YR": "0.00",
    • "price_taxBreakdown_Other": "0.00",
    • "price_discount": "0",
    • "price_ait": "0",
    • "price_service_charge": "0.00",
    • "price_gross_base_fare": "0.00",
    • "price_gross_tax": "0.00",
    • "ticket_issue_charge": "0",
    • "total_ticket_issue_charge": "0.00",
    • "supplier_currency": "null,",
    • "currencyExchangeRate": "null,",
    • "fmg_total": "1667.67",
    • "fmg_base_fare": "0.00",
    • "fmg_tax": "0.00",
    • "fmg_discount": "0",
    • "fmg_ait": "0",
    • "fmg_service_charge": "0.00",
    • "fmg_gross_base_fare": "0.00",
    • "fmg_gross_tax": "0.00",
    • "fmg_markup_type": "null,",
    • "fmg_charge": "0",
    • "fmg_revenue": "0.00",
    • "supplier_total": "1667.67",
    • "supplier_base_fare": "1667.67",
    • "supplier_tax": "0",
    • "supplier_discount": "0",
    • "supplier_ait": "0",
    • "supplier_service_charge": "0.00",
    • "supplier_gross_base_fare": "0.00",
    • "supplier_gross_tax": "0.00",
    • "supplier_primary_commission": "0",
    • "supplier_segment_feesCalculate": "0",
    • "segment_discount_accountPurpose": "null,",
    • "supplier_per_segment_discount": "0",
    • "supplier_total_segment": "0",
    • "supplier_total_segment_discount": "0",
    • "gross_fare_total": "1667.67",
    • "gross_fare_base_fare": "0.00",
    • "gross_fare_tax": "0.00",
    • "gross_fare_tax_BD": "0.00",
    • "gross_fare_tax_UT": "0.00",
    • "gross_fare_tax_E5": "0.00",
    • "gross_fare_tax_YQ": "0.00",
    • "gross_fare_tax_YR": "0.00",
    • "gross_fare_tax_Other": "0.00",
    • "gross_fare_tax_breakDownJSON": "null,",
    • "gross_fare_discount_amount": "0.00",
    • "gross_fare_ait_amount": "0.00",
    • "gross_fare_service_charge": "0.00",
    • "custom_gross_discount": "0.00",
    • "custom_gross_charges": "0",
    • "custom_gross_service_fee": "0",
    • "custom_gross_markup": "0",
    • "applicable_comission_title": "null,",
    • "discount_comission_ratio": "null,",
    • "discount_comission_type": "null,",
    • "dynamic_markup_type": "null,",
    • "dynamic_markup_title": "null,",
    • "dynamic_markup_ratio": "null,",
    • "passport_copy": "null,",
    • "beneficiary_name": "null,",
    • "beneficiary_relation": "null,",
    • "beneficiary_cnic": "null,",
    • "beneficiary_contact": "null,",
    • "beneficiary_address": "null,",
    • "spouse_adult_name": "null,",
    • "spouse_adult_dob": "null,",
    • "spouse_adult_passportno": "null,",
    • "child1_name": "null,",
    • "child1_dob": "null,",
    • "child1_passportno": "null,",
    • "child2_name": "null,",
    • "child2_dob": "null,",
    • "child2_passportno": "null,",
    • "child3_name": "null,",
    • "child3_dob": "null,",
    • "child3_passportno": "null,",
    • "child4_name": "null,",
    • "child4_dob": "null,",
    • "child4_passportno": "null,",
    • "policyNumber": "null,",
    • "policyVoucher": "null,",
    • "isVoid": "0",
    • "voidDate": "null,",
    • "voidTimestamp": "null,",
    • "isRefund": "0",
    • "refundDate": "null,",
    • "refundTimestamp": "null,",
    • "refundSupplerAmount": "null,",
    • "refundSupplerPenalty": "null,",
    • "refundCharge": "null,",
    • "refundAmount": "null,",
    • "refundPenalty": "null,",
    • "supplement_data": null
    },
  • "partner": {},
  • "supplier": {
    • "info": {
      },
    • "price": {
      }
    }
}

Transfer Management

Cancel Booking

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

Logged-in user member ID

tracking_id
required
string

Transfer booking tracking ID

reason
string

Reason for cancellation (optional)

property name*
additional property
any

Responses

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

Request samples

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

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "reason": "The booking has been successfully canceled.. Refund ref id. ITT-RFD-090326-0055 request for BDT 3335.33 has been successfully submitted. The finance team will proceed to verify and update accordingly.",
  • "reason_admin": null,
  • "tracking_id": "11177303486226194YSHFB",
  • "booking_id": "TR2609MATDA33W",
  • "booking_status": "cancel",
  • "booking_supplier_status": "CANCELLED",
  • "cancellationReference": null,
  • "post_booking_details": {
    • "last_update": "1773035592",
    • "tracking_id": "11177303486226194YSHFB",
    • "booking_id": "TR2609MATDA33W",
    • "supplier_confirmation_id": "148-6021065",
    • "airlines_pnr": "Dubai Airport",
    • "service_type": "TRANSFER",
    • "status": "cancel",
    • "booking_status": "cancel",
    • "generated_date": "2026-03-09"
    },
  • "response_data": {
    • "bookings": [
      ]
    }
}

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