Skip to content

Marhaba Book
Run in Postman

/api/v1/reservation/marhaba-book   
This service is used to perform booking for the marhaba result.

Marhaba Book Request

Tags Attribute Description
MarhabaBookingCriteria (JsonObject)
searchKey*
(String)
A unique search key or identifier associated with the user's search or transaction.
offerId*
(String)
An offer-specific identifier, ensuring clear reference for the selected offer.
totalNet*
(Double)
The total net amount associated with the transaction, usually in a specific currency.
currency*
(String)
The currency in which the transaction is conducted, providing the currency code or abbreviation.
Auxiliaries auxiliaries
(Array)
Contains an array of auxiliaries to be booked.
auxiliaryOfferId
(String)
An offer-specific identifier, ensuring clear reference for the selected auxiliaries.
quantity
(Integer)
This specifies the quantity of auxiliaries being booked
chauffeurServiceDetails chauffeurServiceDetails
(Object)
Contains chauffeur details.
noOfBags
(String)
Number of bags to be picked up by chauffeur
contactNumber
(String)
Contact number of the chauffeur
building
(String)
Specifies building number
street
(String)
Specifies the street
landmark
(String)
landmark of the address
pickupDate
(Date)
Specifies the pick up date
pickupTime
(Time)
Specifies the pick up time
passengers passengers*
(Array)
Details about passengers associated with the marhaba offer.
passengerKey*
(String)
A unique key or identifier for the passenger.
ptc*
(String)
The Passenger Type Code (PTC) that indicates the type of passenger, e.g., "ADT" for an adult.
leadPassenger*
(Boolean)
Indicates whether the passenger is the lead passenger (true) or not (false).
passengerInfo passengerInfo*
(Object)
Contains detailed information about the passenger.
birthDate*
(String)
The passenger's date of birth in the format "YYYY-MM-DD."
gender*
(String)
The gender of the passenger (e.g., "M" for male).
nameTitle*
(String)
The title or salutation of the passenger (e.g., "Mr").
givenName*
(String)
The given name or first name of the passenger.
middleName
(String)
The middle name of the passenger (if applicable).
surname*
(String)
The surname or last name of the passenger.
contact contact*
(Object)
Contains contact information for the passenger.Mandatory field for lead passenger
contactProvided*
(Array)
Provides contact details for the passenger, including email addresses and phone numbers.
emailAddress*
(Array)
Contains email addresses associated with the passenger.
phone*
(Array)
Contains phone numbers associated with the passenger.
phoneNumber*
(String)
The phone number of the passenger.
paymentDetails paymentDetails*
(Object)
Contains information related to the payment details, including card information, payment mode, and address.
cardInfo (String) Information about the payment card, if applicable. It may include encrypted details such as card type, number, and expiration date.
paymentMode (String) The selected payment mode used for the transaction, which could be credit card, debit card, PayPal, etc.
address address (Object) Contains details about the billing or shipping address associated with the payment.
label (String) An optional label or identifier for the address, which can help users distinguish between multiple addresses.
street (String) The street or building information for the address, ensuring accurate delivery or billing.
postalCode (String) The postal or ZIP code of the address, aiding in location-specific identification.
cityName (String) The name of the city or locality associated with the address.
countryCode (String) The country code or abbreviation corresponding to the address's location.

Marhaba Book Response
{
    "searchKey": "59f49d3b-7d63-4fe7-a94a-f3404138777b",
    "offerId": "59f49d3b-7d63-4fe7-a94a-f3404138777b0MARHABASTR00000116",
    "totalNet": 677.25,
    "currency": "AED",
        "auxiliaries": [
        {
            "auxiliaryOfferId": "59f49d3b-7d63-4fe7-a94a-f3404138777b0MARHABASTR00000000_0107",
            "quantity": 2
        }
    ],
    "passengers": [
        {
            "passengerKey": "SH4H23B-1",
            "ptc": "ADT",
            "leadPassenger": true,
            "passengerInfo": {
                "birthDate": "2004-12-15",
                "gender": "M",
                "nameTitle": "Mr",
                "givenName": "Zaid",
                "middleName": "",
                "surname": "Khan"
            },
            "contact": {
                "contactProvided": [
                    {
                        "emailAddress": [
                            "AA@BA.COM"
                        ],
                        "phone": [
                            {
                                "phoneNumber": "2312432345"
                            }
                        ]
                    }
                ]
            }
        },
        {
            "passengerKey": "SH4H23B-2",
            "ptc": "CHD",
            "leadPassenger": true,
            "passengerInfo": {
                "birthDate": "2019-10-15",
                "gender": "F",
                "nameTitle": "Mr",
                "givenName": "Abhishek",
                "middleName": "",
                "surname": "Pandey"
            }
        },
        {
            "passengerKey": "SH4H23B-3",
            "ptc": "CHD",
            "leadPassenger": true,
            "passengerInfo": {
                "birthDate": "2012-04-15",
                "gender": "F",
                "nameTitle": "Mr",
                "givenName": "Prince",
                "middleName": "",
                "surname": "Kumar"
            }
        }
    ],
    "paymentDetails": {
        "paymentMode": "CR",
        "cardInfo": "",
        "transactionAmount": 182.6,
        "address": {
            "label": "Billing",
            "street": [
                "Beeches Apartment",
                "200 Lampton Road"
            ],
            "postalCode": "TW345RT",
            "cityName": "NYK",
            "countryCode": "USA"
        }
    }
}


Marhaba Book Response

After sending the marhaba book request Travlinq will book the selected marhaba .

Tags Attribute Description
meta meta
(Object)
success
(String)
Response status will be return Ex: "true"
statusCode
(Boolean)
Response statusCode will be return Ex: "1"
statusMessage
(String)
Response statusMessage will be return Ex: "SUCCESS"
actionType
(String)
Describes the type of action related to the response, in this case, "Marhaba booking."
conversationId
(String)
Unique ID associated with the conversation or request, "fe22cb8d-67e9-4c29-92af-e44dxxxcb9a9" in this example.
commonData commonData
(Object)
This tag has the common Data in the response.
searchKey *
(String)
A unique search ID, will be returned in the search response.
data data
(Object)
bookingReferenceNumber*
(String)
The unique identifier for the booking reference, e.g., "BKR-2023-9090."
bookingStatus*
(String)
Booking status is shown there eg Confirmed.
transactionDate*
(String)
Date on which booking is done
clientReference*
(String)
Specifies the client reference
supplierReferenceId*
(String)
Specifies referenceId of the supplier
Marhaba marhaba
(Object)
This tag has the common Data in the response.
offerId
(String)
Name of the marhaba
productName
(String)
Name of the marhaba
productCode
(String)
Code of the marhaba
productCategory
(String)
Category of the marhaba
productDescription
(String)
Category of the marhaba
Auxiliaries auxiliaries
(Array)
Contains an array of auxiliaries to be booked.
auxiliaryOfferId
(String)
An offer-specific identifier, ensuring clear reference for the selected auxiliaries.
quantity
(Integer)
This specifies the quantity of auxiliaries being booked
chauffeurServiceDetails chauffeurServiceDetails
(Array)
Contains an array of chauffeurs.
noOfBags
(String)
Number of bags to be picked up by chauffeur
contactNumber
(String)
Contact number of the chauffeur
building
(String)
Specifies building number
street
(String)
Specifies the street
landmark
(String)
landmark of the address
pickupDate
(Date)
Specifies the pick up date
pickupTime
(Time)
Specifies the pick up time
Pricing Info pricingInfo
(Object)
This tag has the common Data in the response.
netAmount
(Double)
Amount of the auxiliary
currency *
(String)
Indicates the currency code, such as "AED," associated with the product's pricing.
customerAdditionalFareInfo customerAdditionalFareInfo
(Object)
Additional fare information related to customer
transactionFeeEarned
(Double)
This attribute contains the transaction fee amount.
commissionEarned
(Double)
Commission amount will be shown here.
markupEarned
(Double)
Total markup amount from pricing rule will be shown here.
discount
(Double)
Total discount amount from pricing rule will be shown here.
vat
(Double)
Vat received from pricing model (if vat rule is applied)
plbearned
(Double)
plbearned will be shown
incentiveEarned
(Double)
Incentive amount earned
tdsOnIncentive
(Double)
tds amount on incentive will be shown
Marhaba Book Response
{
    "meta": {
        "success": true,
        "statusCode": 1,
        "statusMessage": "SUCCESS",
        "actionType": "MARHABA_BOOK",
        "conversationId": "b4e30446-86db-43d3-b4c6-a2f0e471a00a"
    },
    "data": [
        {
            "bookingReferenceId": "BKR-2023-005545",
            "supplierLocator": "M70049571",
            "marhaba": {
                "offerId": "59f49d3b-7d63-4fe7-a94a-f3404138777b0MARHABASTR00000116",
                "productName": "Gold Meet & Greet T2-A",
                "productCode": "DXB_GMG_T2_A",
                "productCategory": "Meet & Greet",
                "productDescription": "<h3>Key Services</h3> Our Gold Meet & Greet product provide an exclusive one-to-one service. A marhaba representative will meet you at the marhaba drop-off point outside the airport and fast-track you through all the airport formalities. We’ll provide porter services, hand baggage trolleys and wheelchairs on request in Dubai. You can also enjoy complimentary access to the exclusive marhaba Lounge. Relax and enjoy our full buffet, beverages and facilities. In Dubai, the meeting place is a dedicated point in the departure check-in area. There is a marhaba Meeting Lounge near the check-in area at Dubai International Terminal 3 where you can relax, recharge and enjoy light refreshments before we escort you through the airport.</br><br><h3>Best for</h3>• Business travellers </br>• Senior travellers </br>• Travellers with special needs </br>• Travellers requiring language help</br><br><h3>Features</h3>• Exclusive one-to-one service </br>• Meet and greet on arrival in the terminal </br>• Fast-track through immigration and security </br>• An escort right to the meeting point in the arrivals hall </br>• Hand baggage trolleys on request </br>• Porter service from baggage reclaim </br>• Guides with multiple languages on request </br>• Departure Lounge access for your return flight from Dubai",
                "serviceDate": "11/29/2023",
                "auxiliaries": [
                    {
                        "auxiliaryOfferId": "59f49d3b-7d63-4fe7-a94a-f3404138777b0MARHABASTR00000116_0000",
                        "productName": "porter service",
                        "productCode": "DXB_PORTR_A",
                        "productCategory": "Auxiliary",
                        "pricingInfo": {
                            "netAmount": 30.0,
                            "currency": "AED"
                        }
                    }
                ],
                "pricingInfo": {
                    "netAmount": 677.25,
                    "currency": "AED",
                    "customerAdditionalFareInfo": {
                        "transactionFeeEarned": 0.0,
                        "commissionEarned": 0.0,
                        "markupEarned": 0.0,
                        "discount": 0.0,
                        "vat": 0.0,
                        "plbearned": 0.0,
                        "incentiveEarned": 0.0,
                        "tdsOnIncentive": 0.0
                    }
                }
            },
            "passengers": [
                {
                    "passengerKey": "SH4H23B-1",
                    "ptc": "ADT",
                    "leadPassenger": true,
                    "passengerInfo": {
                        "birthDate": "2004-12-15",
                        "gender": "M",
                        "nameTitle": "Mr",
                        "givenName": "Zaid",
                        "middleName": "",
                        "surname": "Khan"
                    },
                    "contact": {
                        "contactProvided": [
                            {
                                "emailAddress": [
                                    "AA@BA.COM"
                                ],
                                "phone": [
                                    {
                                        "phoneNumber": "2312432345"
                                    }
                                ]
                            }
                        ]
                    }
                },
                {
                    "passengerKey": "SH4H23B-2",
                    "ptc": "CHD",
                    "leadPassenger": true,
                    "passengerInfo": {
                        "birthDate": "2019-10-15",
                        "gender": "F",
                        "nameTitle": "Mr",
                        "givenName": "Abhishek",
                        "middleName": "",
                        "surname": "Pandey"
                    }
                },
                {
                    "passengerKey": "SH4H23B-3",
                    "ptc": "CHD",
                    "leadPassenger": true,
                    "passengerInfo": {
                        "birthDate": "2012-04-15",
                        "gender": "F",
                        "nameTitle": "Mr",
                        "givenName": "Prince",
                        "middleName": "",
                        "surname": "Kumar"
                    }
                }
            ]
        }
    ],
    "version": "1.0.0"
}