Retrieve Full Booking Details Using Reference Locator

The BookingDetail operation allows to retrieve a booking with all its details from the booking reference locator.

Parameters

Name

Description

Accept

string

( header )

Must be application/json

Accept - Encoding

string

( header )

Must be gzip

Authorization

string

( header )

Must be Your PID

Must be Your API Key

Customer-Ip

string

( header )

Must be IP address of the customer, as captured by your integration. Send IPV4 addresses only.

Ensure your integration passes the customer’s IP, not your own. This value helps determine their location and other settings.

Also used for fraud recovery and other important analytics.

Definition and request parameters for transfer retrieve booking

action

string

( query )

Must be "bookingDetail" as parameter

booking_reference

string

(required)

Booking reference number taken from the confirmation response.

order_id

string

(optional)

The Order ID generated at the time of booking.

REQUEST

API Endpoint: https://www.abengines.com/api/v1/travel-api/transfer-booking/

header: array(
'Content-Type:application/json',
'Accept-encoding: gzip',
'PID:'ADD-YOUR-PID',
'x-api-key:'ADD-YOUR-KEY'
);

POST: 
{
  "action": "bookingDetail",
  "booking_reference": "207-9502843",
  "order_id": "12345678"
}

Response

The API returns an HTTP response, which generally includes the result of the request invocation

{
  "status": 200,
  "status_message": "OK",
  "responseData": {
    "bookings": [
      {
        "reference": "207-9502843",
        "bookingFileId": null,
        "creationDate": "2023-07-29T12:18:59",
        "status": "CONFIRMED",
        "modificationsPolicies": {
          "cancellation": true,
          "modification": true
        },
        "holder": {
          "name": "Test",
          "surname": "Booking",
          "email": "praveen@thewebconz.com",
          "phone": "8802273456"
        },
        "transfers": [
          {
            "id": 1,
            "status": "CONFIRMED",
            "transferType": "PRIVATE",
            "vehicle": {
              "code": "CR",
              "name": "Car"
            },
            "category": {
              "code": "PRM",
              "name": "Premium"
            },
            "pickupInformation": {
              "from": {
                "code": "5643",
                "description": "Sistina",
                "type": "ATLAS"
              },
              "to": {
                "code": "CIA",
                "description": "Rome, Ciampino Airport",
                "type": "IATA"
              },
              "date": "2023-08-12",
              "time": "06:40:00",
              "pickup": {
                "address": "Via Sistina,136  ",
                "number": null,
                "town": "ROME",
                "zip": "00187",
                "description": "You will be picked up at the hotel reception. If you are unable to locate the driver/agent, please call KOI TECHNOLOGIES on +971 567562977 (WhatApp available), +971 45754333. Please do not leave the pick-up area without having contacted the agent/driver first. If the supplier doesn't answer the phone, please call our emergency telephone number listed at the bottom of the voucher before leaving the pick-up area.",
                "altitude": null,
                "latitude": 41.904008,
                "longitude": 12.487254,
                "checkPickup": {
                  "mustCheckPickupTime": false,
                  "url": null,
                  "hoursBeforeConsulting": null
                },
                "pickupId": 23229,
                "stopName": "HOTEL RECEPTION",
                "image": null
              }
            },
            "paxes": [
              {
                "type": "ADULT",
                "age": 30
              }
            ],
            "content": {
              "vehicle": {
                "code": "CR",
                "name": "Car"
              },
              "category": {
                "code": "PRM",
                "name": "Premium"
              },
              "images": [
                {
                  "url": "http://media.activitiesbank.com/giata/transfers/TRD/small/prvt-prm-cr.png",
                  "type": "SMALL"
                },
                {
                  "url": "http://media.activitiesbank.com/giata/transfers/TRD/medium/prvt-prm-cr.png",
                  "type": "MEDIUM"
                },
                {
                  "url": "http://media.activitiesbank.com/giata/transfers/TRD/large/prvt-prm-cr.png",
                  "type": "LARGE"
                },
                {
                  "url": "http://media.activitiesbank.com/giata/transfers/TRD/extralarge/prvt-prm-cr.png",
                  "type": "EXTRALARGE"
                }
              ],
              "transferDetailInfo": [
                {
                  "id": "ER",
                  "name": "Exclusive ride for you",
                  "description": null,
                  "type": "GENERAL_INFO"
                },
                {
                  "id": "DTDS",
                  "name": "Door to door service",
                  "description": null,
                  "type": "GENERAL_INFO"
                },
                {
                  "id": "M&GS",
                  "name": "Meet & Greet service",
                  "description": null,
                  "type": "GENERAL_INFO"
                },
                {
                  "id": "BAHB",
                  "name": "1 item of hand baggage allowed per person",
                  "description": null,
                  "type": "GENERAL_INFO"
                },
                {
                  "id": "BA",
                  "name": "1 piece of baggage allowed per person ( max.dimensions 158cm) length+width+height=158cm",
                  "description": null,
                  "type": "GENERAL_INFO"
                },
                {
                  "id": "VOUC",
                  "name": "VOUCHER ",
                  "description": "Remember to bring a printed copy of this voucher and a valid photo ID with you.",
                  "type": "GENERIC_GUIDELINES"
                },
                {
                  "id": "DRVR",
                  "name": "CAN'T FIND DRIVER",
                  "description": "In the event of being unable to locate the driver, please call the emergency number indicated in this voucher.",
                  "type": "GENERIC_GUIDELINES"
                },
                {
                  "id": "MGEN",
                  "name": "Meet and Greet in English",
                  "description": "Meet and Greet in English",
                  "type": "GENERIC_GUIDELINES"
                },
                {
                  "id": "CBBS",
                  "name": "CHILDBOOSTER / BABY SEAT",
                  "description": "Child car seats and boosters are not included unless specified in your booking and can carry an extra cost. Should you need to book them, please contact your point of sale prior to travelling.",
                  "type": "GENERIC_GUIDELINES"
                },
                {
                  "id": "PLEGACHAIR",
                  "name": "Foldable wheelchairs",
                  "description": "Adapted vehicles are suitable for foldable wheelchairs. If the wheelchair cannot be folded, an extra cost may be applicable for customers",
                  "type": "GENERIC_GUIDELINES"
                }
              ],
              "customerTransferTimeInfo": [
                {
                  "value": 0,
                  "type": "CUSTOMER_MAX_WAITING_TIME",
                  "metric": "minutes"
                }
              ],
              "supplierTransferTimeInfo": [
                {
                  "value": 15,
                  "type": "SUPPLIER_MAX_WAITING_TIME_DOMESTIC",
                  "metric": "minutes"
                }
              ],
              "transferRemarks": [
                {
                  "type": "CONTRACT",
                  "description": "Pick-up point:\nYou will be picked up at the hotel reception. If you are unable to locate the driver/agent, please call KOI TECHNOLOGIES on +971 567562977 (WhatApp available), +971 45754333. Please do not leave the pick-up area without having contacted the agent/driver first. If the supplier doesn't answer the phone, please call our emergency telephone number listed at the bottom of the voucher before leaving the pick-up area.\n\nTransfer information:\n\n* Maximum client waiting time 0 minutes\n* Maximum waiting time for drivers in domestic arrivals 15 minutes\n\n* Remember to bring a printed copy of this voucher and a valid photo ID with you.\n* In the event of being unable to locate the driver, please call the emergency number indicated in this voucher.\n* Meet and Greet in English\n* Child car seats and boosters are not included unless specified in your booking and can carry an extra cost. Should you need to book them, please contact your point of sale prior to travelling.\n* Adapted vehicles are suitable for foldable wheelchairs. If the wheelchair cannot be folded, an extra cost may be applicable for customers\n\n* Exclusive ride for you:  \n* Door to door service:  \n* Meet & Greet service:  \n* 1 item of hand baggage allowed per person:  \n* 1 piece of baggage allowed per person ( max.dimensions 158cm) length+width+height=158cm:  \n\n",
                  "mandatory": true
                }
              ]
            },
            "price": {
              "totalAmount": 10632.15,
              "netAmount": 10632.15,
              "currencyId": "INR"
            },
            "cancellationPolicies": [
              {
                "amount": 10632.15,
                "from": "2023-08-09T00:00:00",
                "currencyId": "INR",
                "isForceMajeure": false
              }
            ],
            "factsheetId": 1391,
            "arrivalFlightNumber": null,
            "departureFlightNumber": "SPIJ45",
            "arrivalShipName": null,
            "departureShipName": null,
            "arrivalTrainInfo": null,
            "departureTrainInfo": null,
            "transferDetails": [
              {
                "type": "FLIGHT",
                "direction": "DEPARTURE",
                "code": "SPIJ45",
                "companyName": null
              }
            ],
            "sourceMarketEmergencyNumber": "+34871180153",
            "links": [
              {
                "rel": "transferCancel",
                "method": "DELETE"
              }
            ]
          }
        ],
        "clientReference": "5F816749F3A14",
        "remark": "",
        "totalAmount": 10632.15,
        "totalNetAmount": 10632.15,
        "pendingAmount": 10632.15,
        "currency": "INR"
      }
    ]
  }
}