Skip to content

Car Book Retrieve

api/v1/reservation/car-book-retrieve

The Booking Enquiry operation allows you to retrieve booking details. The response body for the booking retrieval will be same as the booking response. If an issue arise while doing the booking, this could be used to verify the status of the booking. If somehow the bookingId is not available clientId or the bookingKey could be used

Car Book Retrieve Request

Tags Attribute Description
carBookingRetrieveCriteria (JsonObject)
productType *
(String)
For cars the product type should be 'C'
bookingReferenceId *
(String)
Booking reference id need to passed in the retrieve request.In this request either booking reference id or the client reference id need to be passed in the retrieve request or both can be passed.
clientReferenceId *
(String)
Client reference id need to passed in the retrieve request.
Car booking retrieve request
1
2
3
4
{
  "bookingReferenceId": "BKR-2022-004052",
  "clientReferenceId": "2020-1004"
}

Car Book Retrieve Response

Following table contains the attributes of the booking response and the description.

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"
commonData commonData
(Object)
This tag has the common Data in the response.
data data
(Object)
bookingReferenceId*
(String)
Generated booking reference.
supplierLocator*

(String)
This tag contains the supplier locator or the supplier booking reference.
clientReference *

(String)
This attribute should be same as the client reference that has been passed during booking request
2023-04-10T10:00
bookingStatus *

(String)
This attribute contains the booking status
CONFIRMED
transactionDate *

(String)
This attribute contains the date of the transaction or the date of the booking.
vehicleInfo vehicleInfo*
(Object)
This tag contains the vehicle information for the booked car result.
vehMakeModel *
(String)
This attribute contains the vehicle model
code *
(String)
This attribute contains the car code
model *
(String)
This attribute contains the vehicle model
vehClass*
(String)
This attribute contains the vehicle class
imageUrl (String) This attribute contains the image url
notes*
(String)
Warning details will be added as the notes in the booking response.
guaranteeInd *

(String)
This attribute indicates the guaranteed indicator
vehicleTypeInfo vehicleTypeInfo
*
(Object)
This tag contains the vehicle type information.
category
*
(String)
Category of the car. Eg: Compact,Economy,Luxury,Mini,Standard
categoryId
(String)
Category id of the car.
doorCount*

(String)
Door count of the will be shown here.
arConditioned *

(String)
transmissionInfo transmissionInfo*
(Object)
This attribute indicates transmission information of the car.
type
*
(String)
This attribute indicates whether this is a manual or automatic car
passengerQuantity*

(String)
Number of passengers will be shown here.
smallBaggageQuantity
(String)
Baggage quantity related information will be shown here.
largeBaggageQuantity
(String)
Baggage quantity related information will be shown here.
totalBaggageQuantity*

(String)
Baggage quantity related information will be shown here.
prepaid *

(Boolean)
This attribute indicates whether this is a pre paid reservation or not.
fuelInfo fuelInfo *

(String)
This tag contains the fuel related information of the car.
fuelType *

(String)
excessDetail
(String)
vehicleRate vehicleRate *

(Object)
This tag contains the price related information of the relevant car.
vehicleCharge vehicleCharge *

(Object)
amount *

(Double)
Amount attribute contains the total fare of the reservation.
oldFare *

(Double)
This attribute shows the previous total fare before doing the reprice. This attribute available in pre book call only.
currencyCode*
(String)
Currency code received
amount *

(Double)
Amount attribute contains the total fare of the reservation.
currencyCode*
(String)
This attribute contains the client currency.
taxes taxes
(List)
This tag contains all the out put taxes which are included in the total fare.
name *

(String)
amount *

(Double)
included
(Boolean)
This attribute shows whether the tax amount is included in the above total fare amount.
supplierAdditionalFareInfo supplierAdditionalFareInfo(JsonObject) Additional fare information related to supplier
currency
(String)
Currency received in supplier response (Buying currency)
discount
(Double)
Any discount return in supplier response (Currently car suppliers do not return any discount )
publishedFare
(Double)
Amount received in supplier response (Buying amount)
commissionEarned
(Double)
Any commission amount returned in supplier response (Currently car suppliers do not return any commission value)
offeredFare
(Double)

Not released yet
tdsOnCommission
(Double)

Not released yet
serviceFee
(Double)

Not released yet
customerAdditionalFareInfo customerAdditionalFareInfo(JsonObject) Additional fare information related to customer
transactionFeeEarned
(Double)
This attribute contains the transaction fee amount.
tdsOnCommission
(Double)
Commission amount on tds will be shown here.
Not released yet
commissionEarned
(Double)
This attribute shows the total commission amount.
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)
cgst
(Double)
GST received from pricing model if applicable.Currently there is no gst component for cars
Not released yet
sgst
(Double)

Not released yet
igst
(Double)

Not released yet
pricedCoverages pricedCoverages*

(List)
Priced coverage tag shows all the inclusions and exclusions.
description *

(String)
included*
(Boolean)
This attribute shows whether the mentioned fare information is an inclusion or not
financialInfo financialInfo *

(Object)
supplier *

(String)
subSupplierCode (String) Not released yet
payment payment
(Object)
Not released yet
tmc
(String)
This tag contains supplier owner name.
tmc - Travel Management Company. Not released yet
paymentTypes
(String)
Not released yet
paymentNetwork
(String)
Not released yet
passengers (JsonObject)
passenger (JsonArray)
passengerKey*
(String)
this is the unique key for the passenger
isLead*
(Boolean)
true if for the lead passenger
ptc*
(String)
passenger type (adult, child)
passenger's meal preference
passengerInfo (JsonArray)
givenName*
(String)
first name
middleName*
(String)
middle name should be passed if pan is mandatory in Hotel room service
surName*
(String)
surname
gender*
(String)
gender
nameTitle*
(String)
salutation Eg(mr,ms)
birthday*
(String)
passenger's birthdate
contact (JsonArray)
postalAddress (JsonObject)
label
(String)
label
Not released yet
street
(String)
street name
Not released yet
postalCode
(String)
postal code
Not released yet
cityName
(String)
city name
Not released yet
countryCode
(String)
country code
Not released yet
contactsProvided (JsonArray) Supports only for a single contact provide
contactsProvided (JsonObject)
emailAddress*
(listOfString)
email address - supports only for a single email id
phone (JsonObject)
label
(String)
label
Not released yet
phoneNumber *
(String)
phone number
areaCode *
(String)

Not released yet
loyaltyProgramAccount (JsonObject)
accountNumber
(String)
account number
Not released yet
dateOfIssue
(String)
date of issue
Not released yet
placeOfIssue
(String)
place of issue
Not released yet
expDate
(String)
expiry date
Not released yet
identityDocument (JsonObject)
idType
(String)
identification type (PAN,PASSPORT) are the supported types
Not released yet
idDocumentNumber
(String)
id number
Not released yet
isCorporatePAN
(String)
(only for PAN type) - if it is a corporate PAN
Not released yet
issuingCountryCode
(String)
country of issue
Not released yet
applicableCountry
(String)
applicable country
Not released yet
Not released yet
placeOfBirth
(String)
birth place
Not released yet
dateOfIssue
(String)
issue date
Not released yet
residenceCountryCode
(String)
residence country
Not released yet
Not released yet
expiryDate
(String)
expiry date
Not released yet
vehicleLocationDetails vehicleLocationDetails
(Object)
pickUpLocationDetail pickUpLocationDetail*

(Object)
Pick up location related information will be shown in this tag.
name *
(String)
address *

(String)
phoneNumber *

(String)
locationInfo *

(String)
longitude
(String)
latitude
(String)
workingHoursDetails workingHoursDetails*

(Object)
This tag contains the working hours related information.
day *

(String)
This attribute contains the working day
openHours *
(String)
This attribute contains the working hours - start time
closeHours *
(String)
This attribute contains the working hours - end time
dropOffLocationDetail dropOffLocationDetail*

(Object)
Drop off location related information will be shown in this tag.
name*
(String)
address *

(String)
phoneNumber*

(String)
locationInfo
(String)
longitude
(String)
latitude
(String)
workingHoursDetails workingHoursDetails*

(Object)
This tag contains the working hours related information.
day *

(String)
This attribute contains the working day
openHours *
(String)
This attribute contains the working hours - start time
closeHours *
(String)
This attribute contains the working hours - end time
Car Pre Book Request
{
  "meta": {
    "success": true,
    "statusCode": "",
    "statusMessage": "",
    "additionalProperties": [
      {
        "key": "timeStamp",
        "value": "YYYY-MM-DD HH:MM:SST",
        "description": "description"
      },
      {
        "key": "serverKey",
        "value": "Server01",
        "description": "description"
      }
    ]
  },
  "warnings": [
    {
      "code": "validation_required",
      "documentationUrl": "api-doc/docs/troubleshoot/api-error-codes/index.html",
      "message": "Passenger contact information must be provided.",
      "value": "Passenger contact information must be provided."
    }
  ],
  "errors": [
    {
      "code": "validation_required",
      "documentationUrl": "api-doc/docs/troubleshoot/api-error-codes/index.html",
      "message": "Field 'bookingReferenceId' can't be blank",
      "value": "Field 'bookingReferenceId' can't be blank",
      "source": {
        "field": "bookingReferenceId",
        "pointer": "/CarBooking/bookingReferenceId"
      },
      "title": "Required field",
      "type": "validation_error"
    }
  ],
  "data": [
    {
      "bookingReferenceId": "BKR-2023-0089",
      "clientReference": "BKR-CAR-00001",
      "supplierLocator": "4H122034-FXA-3838029-3816381",
      "bookingStatus": "Not Available",
      "transactionDate": "2022-11-09T10:02:01",
      "vehicleInfo": {
        "vehMakeModel": "B TOYOTA YARIS OR SIMILAR",
        "code": "EDAR",
        "model": "B TOYOTA YARIS OR SIMILAR",
        "vehClass": "economy",
        "imageUrl": "appxtension image ZEAEEDAR999.jpg",
        "notes": "Vehicle rate notes",
        "guaranteeInd": "G",
        "vehicleTypeInfo": {
          "category": "Economy",
          "categoryId": "",
          "doorCount": 4,
          "airConditioned": true,
          "additionalProperties": [
            {
              "key": "timeStamp",
              "value": "YYYY-MM-DD HH:MM:SST",
              "description": "description"
            },
            {
              "key": "serverKey",
              "value": "Server01",
              "description": "description"
            }
          ]
        },
        "transmissionInfo": {
          "type": "Automatic",
          "passengerQuantity": 3,
          "smallBaggageQuantity": 2,
          "largeBaggageQuantity": 1,
          "totalBaggageQuantity": 3,
          "prepaid": true,
          "additionalProperties": [
            {
              "key": "timeStamp",
              "value": "YYYY-MM-DD HH:MM:SST",
              "description": "description"
            },
            {
              "key": "serverKey",
              "value": "Server01",
              "description": "description"
            }
          ]
        },
        "fuelInfo": {
          "fuelType": "Petrol",
          "excessDetail": "",
          "additionalProperties": [
            {
              "key": "timeStamp",
              "value": "YYYY-MM-DD HH:MM:SST",
              "description": "description"
            },
            {
              "key": "serverKey",
              "value": "Server01",
              "description": "description"
            }
          ]
        },
        "vehicleRate": {
          "vehicleCharge": {
            "amount": 340,
            "currencyCode": "AED"
          },
          "taxes": [
            {
              "name": "VAT on NT & TF",
              "amount": 54.45,
              "included": true
            }
          ],
          "supplierAdditionalFareInfo": {
            "currency": "AED",
            "discount": 0,
            "publishedFare": 340,
            "commissionEarned": 0,
            "offeredFare": 0,
            "tdsOnCommission": 0,
            "serviceFee": 0,
            "additionalProperties": [
              {
                "key": "key1",
                "value": "value1",
                "description": "description"
              },
              {
                "key": "key1",
                "value": "value1",
                "description": "description"
              }
            ]
          },
          "customerAdditionalFareInfo": {
            "transactionFeeEarned": 0,
            "tdsOnCommission": 0,
            "commissionEarned": 0,
            "markupEarned": 0,
            "discount": 0,
            "vat": 0,
            "cgst": 0,
            "sgst": 0,
            "igst": 0,
            "additionalProperties": [
              {
                "key": "key1",
                "value": "value1",
                "description": "description"
              },
              {
                "key": "key1",
                "value": "value1",
                "description": "description"
              }
            ]
          },
          "additionalProperties": [
            {
              "key": "key1",
              "value": "value1",
              "description": "description"
            },
            {
              "key": "key1",
              "value": "value1",
              "description": "description"
            }
          ]
        },
        "pricedCoverages": [
          {
            "description": "LOCATION SERVICE CHARGE:(0.00AED)",
            "isIncluded": true,
            "additionalProperties": [
              {
                "key": "timeStamp",
                "value": "YYYY-MM-DD HH:MM:SST",
                "description": "description"
              },
              {
                "key": "serverKey",
                "value": "Server01",
                "description": "description"
              }
            ]
          }
        ],
        "financialInfo": {
          "tmc": "VE",
          "supplier": "Hertz",
          "subSupplierCode": "NCEPF3141",
          "payment": {
            "paymentTypes": [
              "CARD,CR"
            ],
            "paymentNetwork": [
              "DS,CA,DC,VI,AX"
            ]
          },
          "additionalProperties": [
            {
              "key": "key1",
              "value": "value1",
              "description": "description"
            },
            {
              "key": "key1",
              "value": "value1",
              "description": "description"
            }
          ]
        },
        "vehicleLocationDetails": {
          "pickUpLocationDetail": {
            "name": "DUBAI INT'L AIRPORT TEM3",
            "address": "Dubai Hotel",
            "phoneNumber": "+913456789",
            "locationInfo": "",
            "longitude": "55.291822",
            "latitude": "45.291822",
            "workingHoursDetails": [
              {
                "day": "Mon",
                "openHours": "00:01",
                "closeHours": "23:59"
              }
            ],
            "additionalProperties": [
              {
                "key": "timeStamp",
                "value": "YYYY-MM-DD HH:MM:SST",
                "description": "description"
              },
              {
                "key": "serverKey",
                "value": "Server01",
                "description": "description"
              }
            ]
          },
          "dropOffLocationDetail": {
            "name": "DUBAI INT'L AIRPORT TEM3",
            "address": "Beeches Apartment",
            "phoneNumber": "+91711045678",
            "locationInfo": "",
            "longitude": "25.250688",
            "latitude": "55.291822",
            "workingHoursDetails": [
              {
                "day": "Mon",
                "openHours": "00:01",
                "closeHours": "23:59"
              }
            ],
            "additionalProperties": [
              {
                "key": "timeStamp",
                "value": "YYYY-MM-DD HH:MM:SST",
                "description": "description"
              },
              {
                "key": "serverKey",
                "value": "Server01",
                "description": "description"
              }
            ]
          },
          "additionalProperties": [
            {
              "key": "timeStamp",
              "value": "YYYY-MM-DD HH:MM:SST",
              "description": "description"
            },
            {
              "key": "serverKey",
              "value": "Server01",
              "description": "description"
            }
          ]
        }
      }
    }
  ]
}