API docs by Redocly

ITT Transfer 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

payment_type
required
string

Payment method (account_balance / card / onlinepayment)

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)

redirect_url
string

Redirect URL after payment

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",
  • "redirect_url": "https://test.example.com/test-tech/custom_modal.html",
  • "note": "Note to driver",
  • "payment_type": "account_balance",
  • "isd_code": "880",
  • "contact_no": "1966330000",
  • "email_address": "iam@saaqeb.com",
  • "agency_email": "iam@saaqeb.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": "iam@saaqeb.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": [
      ]
    }
}

Booking details

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

Logged-in user member ID

tracking_id
required
string

Transfer or booking tracking ID

booking_id
required
string

Booking ID for the Transfer package

property name*
additional property
any

Responses

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

Request samples

Content type
application/json
{
  • "tracking_id": "71176482474026194FH3BA",
  • "booking_id": "",
  • "member_id": "1"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "reason": "Booking Details For Tracking Id 119177311942703210WDEPJ",
  • "tracking_id": "119177311942703210WDEPJ",
  • "booking_id": "FL2610MAPSA3D7",
  • "pay_tracking_id": null,
  • "sendGTMEvent": false,
  • "general": {
    • "service_type": "FLIGHT",
    • "booking_platform": "B2B",
    • "service_details": "OneWay From KWI to ADJ Departure date 2026-06-11",
    • "booking_remarks": null,
    • "generated_date": "2026-03-10",
    • "partner_id": "1",
    • "master_partner_id": "1",
    • "branch_id": "BDHE001",
    • "IsCardPayBooking": "no",
    • "CardPayStatus": "pending",
    • "CardPayBookingStatus": "processing",
    • "CardPayBookingStatusExecute": "pending",
    • "postBookingProcess": "auto",
    • "book_now_pay_later": "0",
    • "tracking_id": "119177311942703210WDEPJ",
    • "booking_id": "FL2610MAPSA3D7",
    • "airlines_pnr": "XDR1YK",
    • "supplier_confirmation_id": "XDR1YK",
    • "order_id_ndc": null,
    • "order_id_Farelogix": null,
    • "supplier_others_id_a": "NzA5NDkwODQhWERSMVlLIWZhbHNl",
    • "supplier_others_id_b": "120735201421",
    • "externalBookingRefIds": [ ],
    • "supplier_booking_pcc": "NzYxMTI1MzQhSjk-",
    • "supplier_ticketing_pcc": null,
    • "supplier_provider_code": null,
    • "supplier_is_gds": "NO",
    • "carrier": "J9",
    • "departure_date": "2026-06-11",
    • "arrival_date": "2026-06-11",
    • "isDomestic_Flight": false,
    • "flightSegment": "KWI-ADJ",
    • "cabinPriceClass": "Economy Value",
    • "cabinCode": "EV",
    • "bookingCode": "E",
    • "departure_airport": "KWI",
    • "arrival_airport": "ADJ",
    • "supplier_code": "jazeera_air",
    • "supplier_uid": "F1JS00114",
    • "manualAction": {
      },
    • "member_id": "19",
    • "book_by": "test",
    • "ip_address": "203.76.126.194",
    • "timestamp": "1773119468",
    • "last_update": "1773119468"
    },
  • "changeLogs": [ ],
  • "voucher": {},
  • "action": {
    • "bookingStatus": "Hold",
    • "bookingStatusColor": "#FD7E14",
    • "bookingStatusInfo": "Hold",
    • "supplier_is_gds": "NO",
    • "view_gds_ticket": "NO",
    • "cancel_booking": "YES",
    • "void_ticket": "NO",
    • "cancel_ticket": "NO",
    • "split_booking": "NO",
    • "issue_ticket": "YES",
    • "issue_ticket_card": "YES",
    • "re_issue_ticket": "NO",
    • "issue_ticket_partial_pay": "NO",
    • "refund_quote": "NO",
    • "sync_booking": "YES",
    • "booking_info_update": "NO",
    • "ticket_issue_date": "",
    • "applied_flight_departure_date": "2026-06-10",
    • "flight_departure_date": "2026-06-11",
    • "current_yyyy_mm_dd": "2026-03-10",
    • "airlines_permission": {
      },
    • "partner_permission": {
      }
    },
  • "voidRefundData": [ ],
  • "reIssueData": [ ],
  • "booking": {
    • "status": "success",
    • "bookingStatus": "Hold",
    • "bookingStatusColor": "#FD7E14",
    • "bookingStatusInfo": "Hold",
    • "booking_status": "hold",
    • "booking_supplier_status": "hold",
    • "ticket_status": "queue",
    • "ticketMsg": null,
    • "payment_status": "pending",
    • "auto_cancel_status": "pending",
    • "partner_timezone": "Asia/Dhaka",
    • "syncTimeLimit": "1",
    • "auto_cancel": "2026-03-10 11:26:08",
    • "auto_cancel_timestamp": "1773120368",
    • "ticketingTimeLimit": "2026-03-10 11:26:08",
    • "supplierTimeLimit": null,
    • "supplierTimeLimitTimezone": null,
    • "show_hold_booking_time_limit": "yes",
    • "show_hold_booking_time_limit_msg": "Thanks For Booking with us.",
    • "OnlineCheckIn": null,
    • "OnlineCheckInText": null
    },
  • "price": {
    • "currency": "BDT",
    • "total_amount": "130950.62",
    • "sell_total_price": "141092.48",
    • "sales_comission": null,
    • "applied_comission_ratio": "0",
    • "customer_markup_policy": null,
    • "partial_pay": {
      },
    • "cancel_reissue_charges": {
      }
    },
  • "bookingPaymentRequestDtata": [ ],
  • "syncData": {
    • "Segment": null,
    • "Travelers": null,
    • "Price": [ ],
    • "FareRules": [ ],
    • "FlightFlown": [ ],
    • "SSR": [ ]
    },
  • "flight": {
    • "modify": {
      },
    • "search_parameter": {
      },
    • "departure": {
      },
    • "arrival": {
      },
    • "departure_airport": "KWI",
    • "departure_city": "Kuwait City",
    • "arrival_airport": "ADJ",
    • "arrival_city": "Amman",
    • "flight_group": [
      ],
    • "price": {
      },
    • "customer_markup_policy": null,
    • "baggage": null,
    • "fare_rules": {
      },
    • "read_ssr": [ ]
    },
  • "additional_baggage": [ ],
  • "additional_meal": [ ],
  • "pax_seat_plan": [ ],
  • "baggage_protection": [ ],
  • "additional_services": [ ],
  • "discount_data": [ ],
  • "pax": {
    • "primary": {
      },
    • "data": [
      ]
    },
  • "invoice_data": [ ],
  • "refund_status_list": [
    • "requested",
    • "processing",
    • "refunded"
    ],
  • "refund_data": [ ],
  • "partner": {},
  • "supplier": {
    • "info": {
      }
    },
  • "terms": {
    • "status": null,
    • "text": null
    },
  • "cancellation_terms": {
    • "status": null,
    • "text": null
    },
  • "special_notice_status": "disable",
  • "special_notice": null
}
←Back to Portal