Booking Request Transfers logo icon


This method will allow you to confirm ratekeys, remember you can confirm one ratekey as well as multiples with same booking reference.


Endpoint:

POST https://api.test.hotelbeds.com/transfer-api/1.0/bookings


Request parameters

Node/Attribute

Type

Mandatory

Description

RQ

Element

Y

Top level

RQ/language

String

Y

Requested language code

RQ/holder

Element

Y

Booking holder/lead passenger information

RQ/holder/name

String

Y

Lead passenger first name

RQ/holder/surname

String

Y

Lead passenger last name

RQ/holder/email

String

Y

Lead passenger contact email

RQ/holder/phone

String

Y

Passenger phone number

RQ/transfers

Array of transfer elements

Y

List of requested transfer services

RQ/transfers/transfer

Element

Y

Information of one requested transfer service

RQ/transfers/transfer/rateKey

String

Y

Rate key to be confirmed taken from the availability step

RQ/transfers/transfer/pickupInformation Element N Custom information used to override default pickup information for the confirmation of GPS services
RQ/transfers/transfer/pickupInformation/name String Y  Pickup address information. NOTE: Mandatory field if the pickupInformation element is sent in the request
RQ/transfers/transfer/pickupInformation/address String Y  Pickup address information. NOTE: Mandatory field if the pickupInformation element is sent in the request
RQ/transfers/transfer/pickupInformation/town String Y Pickup address information. NOTE: Mandatory field if the pickupInformation element is sent in the request
RQ/transfers/transfer/pickupInformation/country String Y Pickup address information. NOTE: Mandatory field if the pickupInformation element is sent in the request
RQ/transfers/transfer/pickupInformation/zip String Y Pickup address information. NOTE: Mandatory field if the pickupInformation element is sent in the request
RQ/transfers/transfer/dropoffInformation String N Custom information used to override default dropoff information for the confirmation of GPS services
RQ/transfers/transfer/dropoffInformation/name String Y Dropoff address information.  NOTE: Mandatory field if the dropoffInformation element is sent in the request
RQ/transfers/transfer/dropoffInformation/address String Y Dropoff address information. NOTE: Mandatory field if the dropoffInformation element is sent in the request
RQ/transfers/transfer/dropoffInformation/town String Y Dropoff address information. NOTE: Mandatory field if the dropoffInformation element is sent in the request
RQ/transfers/transfer/dropoffInformation/country String Y Dropoff address information. NOTE: Mandatory field if the dropoffInformation element is sent in the request
RQ/transfers/transfer/dropoffInformation/zip String Y Dropoff address information.  NOTE: Mandatory field if the dropoffInformation element is sent in the request
RQ/transfers/transfer/transferDetails Array of transfer details elements Y Information about the ride from which the transfer will pick up passengers.
RQ/transfers/transfer/transferDetails/transferDetail Element Y Ride information
RQ/transfers/transfer/transferDetails/transferDetail/type String Y Ride type. Possible values:
  • FLIGHT
  • CRUISE
  • TRAIN
RQ/transfers/transfer/transferDetails/transferDetail/direction String Y Ride direction. Possible values:
  • ARRIVAL
  • DEPARTURE
RQ/transfers/transfer/transferDetails/transferDetail/code String Y Ride identification number(e.g., flight number). NOTE: The character limit in this field is 7 characters.
RQ/transfers/transfer/transferDetails/transferDetail/companyName String N Indicates the name of the company which operates the ride transport. NOTE: Normally used in ship transports.

RQ/clientReference

String

N

Client internal booking reference

RQ/remark

String

N

Comments. NOTE: The character limit in this field is 2000 characters.




Request example (one service)

{
    "language": "en",
    "holder": {
        "title": "Mr",
        "name": "John",
        "surname": "Doe",
        "email": "john.doe@hotelbeds.com",
        "phone": "0016543245812"
    },
    "transfers": [
        {
            "rateKey": "ARRIVAL|IATA|PMI|ATLAS|733|2020-10-20|10:15|2020-10-20|10:15:30|2~0~0|4|110983|PMI PRV MVEL|110983|PMI PRV MVEL|1|PRVT|3|MVEL|STND|60.47|AEROPUERTO|PALMAMELIA|19198|739|PMI|SIMPLE|78eb55ba899e95e4019e4718787eb628",
            "transferDetails": [
                {
                    "code": "IB2580",
                    "companyName": "Ibirria",
                    "direction": "ARRIVAL",
                    "type": "FLIGHT"
                }
            ]
        }
    ],
    "clientReference": "IntegrationAgency",
    "remark": "Booking remarks are to be written here."
}

This will confirm only one service.


Confirming multiple ratekeys (services)

Useful to confirm roundtrips or confirm twice the same service in case the requested paxes can't fit in one service (vehicle).

{
    "language": "en",
    "holder": {
        "title": "Mr",
        "name": "John",
        "surname": "Doe",
        "email": "john.doe@hotelbeds.com",
        "phone": "0016543245812"
    },
    "transfers": [
        {
            "rateKey": "ARRIVAL|IATA|PMI|ATLAS|733|2020-10-20|10:15|2020-10-20|10:15:30|2~0~0|4|110983|PMI PRV MVEL|110983|PMI PRV MVEL|1|PRVT|3|MVEL|STND|60.47|AEROPUERTO|PALMAMELIA|19198|739|PMI|SIMPLE|78eb55ba899e95e4019e4718787eb628",
            "transferDetails": [
                {
                    "code": "IB2580",
                    "companyName": "Ibirria",
                    "direction": "ARRIVAL",
                    "type": "FLIGHT"
                }
            ]
        },
        {
            "rateKey": "ARRIVAL|IATA|PMI|ATLAS|733|2020-10-20|10:15|2020-10-20|10:15:30|2~0~0|4|110983|PMI PRV MVEL|110983|PMI PRV MVEL|1|PRVT|3|MVEL|STND|60.47|AEROPUERTO|PALMAMELIA|19198|739|PMI|SIMPLE|78eb55ba899e95e4019e4718787eb628",
            "transferDetails": [
                {
                    "code": "IB2580",
                    "companyName": "Ibirria",
                    "direction": "ARRIVAL",
                    "type": "FLIGHT"
                }
            ]
        },
        {
            "rateKey": "DEPARTURE|ATLAS|733|IATA|PMI|2020-10-22|10:45|2020-10-22|13:15:30|2~0~0|3|109960|PMI PRV ECO ALL|109960|PMI PRV ECO ALL|1|PRVT|5|CR|ECO|37.4|PALMAMELIA|AEROPUERTO|20068|2248|PMI|SIMPLE|0b521eba2e3bd0c10877839451fc4df1",
            "transferDetails": [
                {
                    "code": "IB2588",
                    "companyName": "Ibirria",
                    "direction": "DEPARTURE",
                    "type": "FLIGHT"
                }
            ]
        },
        {
            "rateKey": "DEPARTURE|ATLAS|733|IATA|PMI|2020-10-22|10:45|2020-10-22|13:15:30|2~0~0|3|109960|PMI PRV ECO ALL|109960|PMI PRV ECO ALL|1|PRVT|5|CR|ECO|37.4|PALMAMELIA|AEROPUERTO|20068|2248|PMI|SIMPLE|0b521eba2e3bd0c10877839451fc4df1",
            "transferDetails": [
                {
                    "code": "IB2588",
                    "companyName": "Ibirria",
                    "direction": "DEPARTURE",
                    "type": "FLIGHT"
                }
            ]
        }
    ],
    "clientReference": "IntegrationAgency",
    "remark": "Booking remarks are to be written here."
}

This request will confirm 4 services (2 cars for arrival + 2 cars for departure).

Note, all ratekeys confirmed in same request will have same booking reference



Post Booking Operations

Once you have confirmed bookings, there's a series of operations that can be performed:

  • BookingDetail : To retrieve the information of a specific booking.

  • BookingList : To retrieve booking list of a specific dates range.

Bear in mind that you will need the booking HB reference of the bookings you carried out to perform post booking operations.


Booking response example

When the confirmation of a rateKey is successful; the booking reference is provided, along with key information of the booking, which includes:

  • Transfer service confirmed, with its locator
  • Holder and pax confirmed
  • Rate confirmed with the confirmed amounts and dates

Please make sure to keep the HB booking reference of all bookings performed with your credentials, as they are needed for post booking operations such as modification or cancellation.


Response parameters

Node/Attribute

Type

Description

RS Element Top level
RS/bookings Array of booking elements List of bookings.
NOTE: in confirmation step you'll always will receive only one booking in this array.
RS/bookings/booking Element Booking information
RS/bookings/booking/reference String

Booking reference. Format: XXX-XXXXXX

RS/bookings/booking/creationDate Date Booking creation date.
Format: YYYY-MM-DD
RS/bookings/booking/status

Booking status.

  • CONFIRMED
  • CANCELLED
  • MODIFIED
RS/bookings/booking/modificationsPolicies Element Information regarding the allowed modifications to the booking
RS/bookings/booking/modificationsPolicies/cancellation Boolean Indicates if the booking can be cancelled
RS/bookings/booking/modificationsPolicies/modification Boolean Indicates if the booking can be modified
RS/bookings/booking/holder Element Booking lead passenger/holder information
RS/bookings/booking/holder/name String First name of the lead passenger
RS/bookings/booking/holder/surname String Last name of the lead passenger
RS/bookings/booking/holder/email String Lead passenger contact email
RS/bookings/booking/holder/phone String Lead passenger contact phone number
RS/bookings/booking/transfers Array of transfer elements List of reserved transfer services
RS/bookings/booking/transfers/transfer Element Information of one reserved transfer service
RS/bookings/booking/transfers/transfer/id Int Transfer service id code
RS/bookings/booking/transfers/transfer/direction String

DEPRECATED: Direction of travel. Possible values:

  • DEPARTURE
  • RETURN
RS/bookings/booking/transfers/transfer/status String

Transfer service status.

  • CONFIRMED
  • CANCELLED
  • MODIFIED
RS/bookings/booking/transfers/transfer/transferType String

Transfer type. Possible values:

  • SHARED
  • PRIVATE
RS/bookings/booking/transfers/transfer/vehicle Element Information of the vehicle
RS/bookings/booking/transfers/transfer/vehicle/code String Vehicle code id
RS/bookings/booking/transfers/transfer/vehicle/name String Vehicle name
RS/bookings/booking/transfers/transfer/category Element Service category information
RS/bookings/booking/transfers/transfer/category/code String Category code
RS/bookings/booking/transfers/transfer/category/name String Category name
RS/bookings/booking/transfers/transfer/pickupInformation Element Information regarding the pickUp locations
RS/bookings/booking/transfers/transfer/pickupInformation/from Element Information regarding the pickUp origin location
RS/bookings/booking/transfers/transfer/pickupInformation/from/code String Code of the pickUp origin location
RS/bookings/booking/transfers/transfer/pickupInformation/from/description String Description of the pickUp origin location
RS/bookings/booking/transfers/transfer/pickupInformation/from/type String

PickUp origin location code type. Possible values:

  • GIATA
  • ATLAS
  • IATA
  • PORT
  • STATION
  • GPS
RS/bookings/booking/transfers/transfer/pickupInformation/to Element Information regarding the pickUp destination location
RS/bookings/booking/transfers/transfer/pickupInformation/to/code String Code of the pickUp destination location
RS/bookings/booking/transfers/transfer/pickupInformation/to/description String Description of the pickUp destination location
RS/bookings/booking/transfers/transfer/pickupInformation/to/type String

PickUp destination location code type. Possible values:

  • GIATA
  • ATLAS
  • IATA
  • PORT
  • STATION
  • GPS
RS/bookings/booking/transfers/transfer/pickupInformation/date String Pickup date
RS/bookings/booking/transfers/transfer/pickupInformation/time String Pickup time
RS/bookings/booking/transfers/transfer/pickupInformation/pickup Element Information of the pickup
RS/bookings/booking/transfers/transfer/pickupInformation/pickup/address String Physical address of the pickup
RS/bookings/booking/transfers/transfer/pickupInformation/pickup/number String Number of the address of the pickup
RS/bookings/booking/transfers/transfer/pickupInformation/pickup/town String City name of the address of the pickup
RS/bookings/booking/transfers/transfer/pickupInformation/pickup/zip String Postal code of the address of the pickup
RS/bookings/booking/transfers/transfer/pickupInformation/pickup/description String Pickup description an instrucctions to reach the place
RS/bookings/booking/transfers/transfer/pickupInformation/pickup/altitude String Elevation from sea level
RS/bookings/booking/transfers/transfer/pickupInformation/pickup/latitude String Latitude data for geolocation
RS/bookings/booking/transfers/transfer/pickupInformation/pickup/longitude String Longitude data for geolocation
RS/bookings/booking/transfers/transfer/pickupInformation/pickup/checkPickup Element Further instructions in order to confirm the exact pickup time

RS/bookings/booking/transfers/transfer/pickupInformation/pickup/checkPickup/mustCheckPickupTime

Boolean

Indicates whether the user needs to confirm exact pickup time on external website

RS/bookings/booking/transfers/transfer/pickupInformation/pickup/checkPickup/url String

URL the user needs to visit in order to confirm pickup time

 RS/bookings/booking/transfers/transfer/pickupInformation/pickup/checkPickup/hoursBeforeConsulting Int

Indicates how many hours before the service, the pickup time will be available on the website

RS/bookings/booking/transfers/transfer/pickupInformation/pickup/pickupId Int Id of the pickup
RS/bookings/booking/transfers/transfer/pickupInformation/pickup/stopName String Name of the stop where the pickup takes place
RS/bookings/booking/transfers/transfer/pickupInformation/pickup/image String Image/map to help locate the pickup
RS/bookings/booking/transfers/transfer/paxes Array of pax elements Collection of passengers in the reservation
RS/bookings/booking/transfers/transfer/paxes/pax Element Passenger information
RS/bookings/booking/transfers/transfer/paxes/pax/type String

Passenger type. Possible values:

  • ADULT
  • CHILD
  • INFANT
RS/bookings/booking/transfers/transfer/content Element Static information of the transfer service
RS/bookings/booking/transfers/transfer/content/vehicle Element Information of the vehicle used in the transfer service
RS/bookings/booking/transfers/transfer/content/vehicle/code String Vehicle code used in the transfer service
RS/bookings/booking/transfers/transfer/content/vehicle/name String Name of the type of the vehicle used in the transfer service
RS/bookings/booking/transfers/transfer/content/category Element Information of the category of the transfer service
RS/bookings/booking/transfers/transfer/content/category/code String Category code of the transfer service
RS/bookings/booking/transfers/transfer/content/category/name String Category name of the ttransfer service category
RS/bookings/booking/transfers/transfer/content/images Array of image elements List of transfer pictures
RS/bookings/booking/transfers/transfer/content/images/image Element Image information
RS/bookings/booking/transfers/transfer/content/images/image/url String Path of the picture file
RS/bookings/booking/transfers/transfer/content/images/image/type String

Type name of the picture. Possible values:

  • SMALL
  • MEDIUM
  • LARGE
  • EXTRALARGE
RS/bookings/booking/transfers/transfer/content/transferDetailInfo Array of transferDetailInfo elements Collection of detailed information about the transfer
RS/bookings/booking/transfers/transfer/content/transferDetailInfo/transferDetailInfo Element Transfer detailed information
RS/bookings/booking/transfers/transfer/content/transferDetailInfo/transferDetailInfo/id String Information id
RS/bookings/booking/transfers/transfer/content/transferDetailInfo/transferDetailInfo/name String Information name
RS/bookings/booking/transfers/transfer/content/transferDetailInfo/transferDetailInfo/description String Details and information on the transfer
RS/bookings/booking/transfers/transfer/content/transferDetailInfo/transferDetailInfo/type String

Transfer detail info type. Possible values:

  • GENERAL_INFO
  • GENERIC_GUIDELINES
RS/bookings/booking/transfers/transfer/content/customerTransferTimeInfo Array of customerTransferTimeInfo elements Information of the customer transfer time
RS/bookings/booking/transfers/transfer/content/customerTransferTimeInfo/TransferTimeInfo Element
Transfer time details
RS/bookings/booking/transfers/transfer/content/customerTransferTimeInfo/TransferTimeInfo/metric String Time unit type
RS/bookings/booking/transfers/transfer/content/customerTransferTimeInfo/TransferTimeInfo/type String

Transfer time info type. Possible values:

  • CUSTOMER_MAX_WAITING_TIME
  • SUPPLIER_MAX_WAITING_TIME_DOMESTIC
  • SUPPLIER_MAX_WAITING_TIME_INTERNATIONAL
RS/bookings/booking/transfers/transfer/content/customerTransferTimeInfo/TransferTimeInfo/value Int Number of units
RS/bookings/booking/transfers/transfer/content/supplierTransferTimeInfo Array of supplierTransferTimeInfo elements Information of the supplier transfer time
RS/bookings/booking/transfers/transfer/content/supplierTransferTimeInfo/TransferTimeInfo Element Transfer time details
RS/bookings/booking/transfers/transfer/content/supplierTransferTimeInfo/TransferTimeInfo/metric String Time unit type
RS/bookings/booking/transfers/transfer/content/supplierTransferTimeInfo/TransferTimeInfo/type String

Transfer time info type. Possible values:

  • CUSTOMER_MAX_WAITING_TIME
  • SUPPLIER_MAX_WAITING_TIME_DOMESTIC
  • SUPPLIER_MAX_WAITING_TIME_INTERNATIONAL
RS/bookings/booking/transfers/transfer/content/supplierTransferTimeInfo/TransferTimeInfo/value Int Number of units
RS/bookings/booking/transfers/transfer/content/transferRemarks Element  Transfer service remarks
RS/bookings/booking/transfers/transfer/content/transferRemarks/type String

Remark possible values:

  • CONTRACT
  • AGENCY
RS/bookings/booking/transfers/transfer/content/transferRemarks/description String  Remark content
RS/bookings/booking/transfers/transfer/content/transferRemarks/mandatory Boolean  Mandatory remark
RS/bookings/booking/transfers/transfer/price Element Price information of the transfer service
RS/bookings/booking/transfers/transfer/price/totalAmount Double Total amount of the booking
RS/bookings/booking/transfers/transfer/price/netAmount Double Net amount of the booking
RS/bookings/booking/transfers/transfer/price/currencyId String Currency
RS/bookings/booking/transfers/transfer/rateKey String Does not apply on Booking response
RS/bookings/booking/transfers/transfer/cancellationPolicies Array of cancellationPolicy elements List of cancellation policies applied to the transfer service
RS/bookings/booking/transfers/transfer/cancellationPolicies/cancellationPolicy Element Information of the cancellation policy
RS/bookings/booking/transfers/transfer/cancellationPolicies/cancellationPolicy/amount Double Amount to be charged in case booking is cancelled after the date specified in the '@from' field.
RS/bookings/booking/transfers/transfer/cancellationPolicies/cancellationPolicy/from String Date from which the amount will be charged, format ISO 8601 (yyyy-MM-ddTHH:mm:ssZ)
RS/bookings/booking/transfers/transfer/cancellationPolicies/cancellationPolicy/currencyId String Currency
RS/bookings/booking/transfers/transfer/links Array of link elements Information on the navigation links available from the current operation
RS/bookings/booking/transfers/transfer/links/link Element Link information
RS/bookings/booking/transfers/transfer/links/link/rel String Specifies the relationship between the current document and the linked document/resource
RS/bookings/booking/transfers/transfer/links/link/href String Specifies the path of the resource the link goes to
RS/bookings/booking/transfers/transfer/links/link/method String HTTP method
RS/bookings/booking/transfers/transfer/factsheetId Int Content card number associated with the transfer, identifies the relationship between type of vehicle, type of service and type of transfer
RS/transfers/transfer/transferDetails Array of transfer details elements Information about the ride from which the transfer will pick up passengers.
RS/transfers/transfer/transferDetails/transferDetail Element Ride information
RS/transfers/transfer/transferDetails/transferDetail/type String Ride type. Possible values:
  • FLIGHT
  • CRUISE
  • TRAIN
RS/transfers/transfer/transferDetails/transferDetail/direction String Ride direction. Possible values:
  • ARRIVAL
  • DEPARTURE
RS/transfers/transfer/transferDetails/transferDetail/code String Ride identification number(e.g., flight number)
RS/transfers/transfer/transferDetails/transferDetail/companyName String Indicates the name of the company which operates the ride transport. NOTE: Normally used in ship transports.

RS/transfers/transfer/sourceMarketEmergencyNumber

String

Source market emergency number

ookingRS/bookings/booking/clientReference String Client internal booking reference
RS/bookings/booking/remark String Comments.NOTE:The character limit in this field is 2000 characters.
RS/bookings/booking/invoiceCompany Element Element that contains information about the invoice company
RS/bookings/booking/invoiceCompany/code String Code of the invoice company
RS/bookings/booking/supplier Element Supplier information  
RS/bookings/booking/supplier/name String Supplier name
RS/bookings/booking/supplier/vatNumber String Supplier VAT number 
RS/bookings/booking/totalAmount String Total amount
RS/bookings/booking/totalNetAmount String Total net amount
RS/bookings/booking/pendingAmount String Pending amount
RS/bookings/booking/currency String Currency
RS/bookings/booking/transfers/transfer/links Array of link elements Information on the navigation links available from the current operation
RS/bookings/booking/transfers/transfer/links/link Element Link information
RS/bookings/booking/transfers/transfer/links/link/rel String Specifies the relationship between the current document and the linked document/resource
RS/bookings/booking/transfers/transfer/links/link/href String Specifies the path of the resource the link goes to
RS/bookings/booking/transfers/transfer/links/link/method String HTTP method
{
    "bookings": [
        {
            "reference": "1-4614587",
            "bookingFileId": null,
            "creationDate": "2020-09-08T14:28:19",
            "status": "CONFIRMED",
            "modificationsPolicies": {
                "cancellation": true,
                "modification": true
            },
            "holder": {
                "name": "John",
                "surname": "Doe",
                "email": "john.doe@hotelbeds.com",
                "phone": "0016543245812"
            },
            "transfers": [
                {
                    "id": 1,
                    "rateKey": "ARRIVAL|IATA|PMI|ATLAS|733|2020-10-20|10:15|2020-10-20|10:15:30|2~0~0|4|110983|PMI PRV MVEL|110983|PMI PRV MVEL|1|PRVT|3|MVEL|STND|49.47|AEROPUERTO|PALMAMELIA|19198|739|PMI|SIMPLE|78eb55ba899e95e4019e4718787eb628",
                    "status": "CONFIRMED",
                    "transferType": "PRIVATE",
                    "vehicle": {
                        "code": "MVEL",
                        "name": "Minivan Extra Luggage"
                    },
                    "category": {
                        "code": "STND",
                        "name": "Standard"
                    },
                    "pickupInformation": {
                        "from": {
                            "code": "PMI",
                            "description": "",
                            "type": "IATA"
                        },
                        "to": {
                            "code": "733",
                            "description": "",
                            "type": "ATLAS"
                        },
                        "date": "2020-10-20",
                        "time": "10:15:00",
                        "pickup": {
                            "address": null,
                            "number": null,
                            "town": null,
                            "zip": null,
                            "description": "Once you have collected your luggage, a staff member will be waiting for you at the Arrivals Hall at the *meeting point area* in front of the arrivals door number 4 with a sign with your name on it. If you are unable to locate the driver/agent, please call TRANSFERS IN DESTINATION on 0034  971578937. Languages spoken at the call centre: English, Spanish, German. 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": null,
                            "longitude": null,
                            "checkPickup": {
                                "mustCheckPickupTime": false,
                                "url": null,
                                "hoursBeforeConsulting": null
                            },
                            "pickupId": 19198,
                            "stopName": "Meeting point area",
                            "image": null
                        }
                    },
                    "paxes": [
                        {
                            "type": "ADULT"
                        },
                        {
                            "type": "ADULT"
                        }
                    ],
                    "content": {
                        "vehicle": {
                            "code": "MVEL",
                            "name": "Minivan Extra Luggage"
                        },
                        "category": {
                            "code": "STND",
                            "name": "Standard"
                        },
                        "images": [
                            {
                                "url": "http://media.stage.activitiesbank.com/giata/transfers/TRD/small/prvt-stnd-mvel.png",
                                "type": "SMALL"
                            },
                            {
                                "url": "http://media.stage.activitiesbank.com/giata/transfers/TRD/medium/prvt-stnd-mvel.png",
                                "type": "MEDIUM"
                            },
                            {
                                "url": "http://media.stage.activitiesbank.com/giata/transfers/TRD/large/prvt-stnd-mvel.png",
                                "type": "LARGE"
                            },
                            {
                                "url": "http://media.stage.activitiesbank.com/giata/transfers/TRD/extralarge/prvt-stnd-mvel.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": "BAHB",
                                "name": "1 item of hand baggage allowed per person",
                                "description": null,
                                "type": "GENERAL_INFO"
                            },
                            {
                                "id": "SPLU",
                                "name": "SPECIAL LUGGAGE",
                                "description": "In the event of extra luggage or sport equipment being checked in, please contact us, as this may carry an extra charge.",
                                "type": "GENERIC_GUIDELINES"
                            },
                            {
                                "id": "LGPR",
                                "name": "LUGGAGE PROBLEMS",
                                "description": "In the event of a delay on your flight or a problem with customs or luggage,  please call the emergency number in order to advise of the delay and take the necessary steps.",
                                "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": "CHIN",
                                "name": "CHECK INFORMATION",
                                "description": "If the details do not correspond with the reservation, please contact your agency immediately.",
                                "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": "RESTACCESS",
                                "name": "restricted access",
                                "description": "Please note that due to traffic restrictions within the city centre there are some hotels in which you will be dropped as close as possible with the chance of a short walk, instead of directly outside.",
                                "type": "GENERIC_GUIDELINES"
                            },
                            {
                                "id": "DOMEST",
                                "name": "Domestic arrivals",
                                "description": "Domestic arrivals: Journeys made within the borders of the same country OR journeys made within European airspace (Schengen) OR from Schengen space to any of these countries: Bulgaria, Cyprus, Croatia, Ireland, United Kingdom and Romania. Passengers do not have to go through customs controll",
                                "type": "GENERIC_GUIDELINES"
                            },
                            {
                                "id": "INTERNAT",
                                "name": "International arrivals",
                                "description": "International arrivals: Journeys where the departure and the arrival take place in different countries OR journeys made with the origin outside of European airspace (Schengen) and arrival into it. Passengers must pass through customs control.",
                                "type": "GENERIC_GUIDELINES"
                            }
                        ],
                        "customerTransferTimeInfo": [],
                        "supplierTransferTimeInfo": [
                            {
                                "value": 60,
                                "type": "SUPPLIER_MAX_WAITING_TIME_DOMESTIC",
                                "metric": "minutes"
                            },
                            {
                                "value": 90,
                                "type": "SUPPLIER_MAX_WAITING_TIME_INTERNATIONAL",
                                "metric": "minutes"
                            }
                        ],
                        "transferRemarks": [
                            {
                                "type": "CONTRACT",
                                "description": "Pick-up point:\nOnce you have collected your luggage, a staff member will be waiting for you at the Arrivals Hall at the *meeting point area* in front of the arrivals door number 4 with a sign with your name on it. If you are unable to locate the driver/agent, please call TRANSFERS IN DESTINATION on 0034  971578937. Languages spoken at the call centre: English, Spanish, German. 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 waiting time for drivers in domestic arrivals 60 minutes\n* Maximum waiting time for drivers in international arrivals 90 minutes\n\n* Maximum capacity per vehicle: 7 Suitcase/s\n\n* Exclusive ride for you:  \n* Door to door service:  \n* 1 item of hand baggage allowed per person:  \n\n",
                                "mandatory": true
                            }
                        ]
                    },
                    "price": {
                        "totalAmount": 49.47,
                        "netAmount": null,
                        "currencyId": "EUR"
                    },
                    "cancellationPolicies": [
                        {
                            "amount": 49.47,
                            "from": "2020-10-19T00:00:00",
                            "currencyId": "EUR"
                        }
                    ],
                    "factsheetId": 739,
                    "arrivalFlightNumber": "IB2580",
                    "departureFlightNumber": null,
                    "arrivalShipName": null,
                    "departureShipName": null,
                    "arrivalTrainInfo": null,
                    "departureTrainInfo": null,
                    "transferDetails": [
                        {
                            "type": "FLIGHT",
                            "direction": "ARRIVAL",
                            "code": "IB2580",
                            "companyName": null
                        }
                    ],
                    "sourceMarketEmergencyNumber": "+34871180153",
                    "links": [
                        {
                            "rel": "transferCancel",
                            "href": "/booking/en/reference/1-4614587/id/1",
                            "method": "DELETE"
                        }
                    ]
                },
                {
                    "id": 2,
                    "rateKey": "DEPARTURE|ATLAS|733|IATA|PMI|2020-10-22|10:45|2020-10-22|13:15:30|2~0~0|3|109960|PMI PRV ECO ALL|109960|PMI PRV ECO ALL|1|PRVT|5|CR|ECO|37.4|PALMAMELIA|AEROPUERTO|20068|2248|PMI|SIMPLE|0b521eba2e3bd0c10877839451fc4df1",
                    "status": "CONFIRMED",
                    "transferType": "PRIVATE",
                    "vehicle": {
                        "code": "CR",
                        "name": "Car"
                    },
                    "category": {
                        "code": "ECO",
                        "name": "Economy"
                    },
                    "pickupInformation": {
                        "from": {
                            "code": "733",
                            "description": "",
                            "type": "ATLAS"
                        },
                        "to": {
                            "code": "PMI",
                            "description": "",
                            "type": "IATA"
                        },
                        "date": "2020-10-22",
                        "time": "10:45:00",
                        "pickup": {
                            "address": null,
                            "number": null,
                            "town": null,
                            "zip": null,
                            "description": "You will be picked up at the hotel reception. If you are unable to locate the driver/agent, please call TRANSFERS IN DESTINATION on 0034  971578937. Languages spoken at the call centre: English, Spanish, German. Please do not leave the pick-up area without having contacted the agent/driver first. The economic car service may vary according to availability, the service can be provided by private car, minivan, minibus, and / or a pre-booked taxi 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": null,
                            "longitude": null,
                            "checkPickup": {
                                "mustCheckPickupTime": false,
                                "url": null,
                                "hoursBeforeConsulting": null
                            },
                            "pickupId": 20068,
                            "stopName": "Hotel reception",
                            "image": null
                        }
                    },
                    "paxes": [
                        {
                            "type": "ADULT"
                        },
                        {
                            "type": "ADULT"
                        }
                    ],
                    "content": {
                        "vehicle": {
                            "code": "CR",
                            "name": "Car"
                        },
                        "category": {
                            "code": "ECO",
                            "name": "Economy"
                        },
                        "images": [
                            {
                                "url": "http://media.stage.activitiesbank.com/giata/transfers/TRD/small/prvt-eco-cr.png",
                                "type": "SMALL"
                            },
                            {
                                "url": "http://media.stage.activitiesbank.com/giata/transfers/TRD/medium/prvt-eco-cr.png",
                                "type": "MEDIUM"
                            },
                            {
                                "url": "http://media.stage.activitiesbank.com/giata/transfers/TRD/large/prvt-eco-cr.png",
                                "type": "LARGE"
                            },
                            {
                                "url": "http://media.stage.activitiesbank.com/giata/transfers/TRD/extralarge/prvt-eco-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": "BA",
                                "name": "1 piece of baggage allowed per person ( max.dimensions 158cm) length+width+height=158cm",
                                "description": null,
                                "type": "GENERAL_INFO"
                            },
                            {
                                "id": "BAHB",
                                "name": "1 item of hand baggage allowed per person",
                                "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": "CHIN",
                                "name": "CHECK INFORMATION",
                                "description": "If the details do not correspond with the reservation, please contact your agency immediately.",
                                "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": "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"
                            }
                        ],
                        "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 TRANSFERS IN DESTINATION on 0034  971578937. Languages spoken at the call centre: English, Spanish, German. Please do not leave the pick-up area without having contacted the agent/driver first. The economic car service may vary according to availability, the service can be provided by private car, minivan, minibus, and / or a pre-booked taxi 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* The private economy vehicle is subject to change due to availability. You may receive your private service in a car, taxi, limousine, van, minibus or a bigger vehicle.:  \n\n* Remember to bring a printed copy of this voucher and a valid photo ID with you.\n* If the details do not correspond with the reservation, please contact your agency immediately.\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* In the event of being unable to locate the driver, please call the emergency number indicated in this voucher.\n\n* Exclusive ride for you:  \n* Door to door service:  \n* 1 piece of baggage allowed per person ( max.dimensions 158cm) length+width+height=158cm:  \n* 1 item of hand baggage allowed per person:  \n\n",
                                "mandatory": true
                            }
                        ]
                    },
                    "price": {
                        "totalAmount": 37.40,
                        "netAmount": null,
                        "currencyId": "EUR"
                    },
                    "cancellationPolicies": [
                        {
                            "amount": 37.40,
                            "from": "2020-10-20T00:00:00",
                            "currencyId": "EUR"
                        }
                    ],
                    "factsheetId": 2248,
                    "arrivalFlightNumber": null,
                    "departureFlightNumber": "IB2580",
                    "arrivalShipName": null,
                    "departureShipName": null,
                    "arrivalTrainInfo": null,
                    "departureTrainInfo": null,
                    "transferDetails": [
                        {
                            "type": "FLIGHT",
                            "direction": "DEPARTURE",
                            "code": "IB2580",
                            "companyName": null
                        }
                    ],
                    "sourceMarketEmergencyNumber": "+34871180153",
                    "links": [
                        {
                            "rel": "transferCancel",
                            "href": "/booking/en/reference/1-4614587/id/2",
                            "method": "DELETE"
                        }
                    ]
                }
            ],
            "clientReference": "INTEGRATIONAGENCY",
            "remark": "",
            "invoiceCompany": {
                "code": "E14"
            },
            "supplier": null,
            "totalAmount": 86.87,
            "totalNetAmount": 86.87,
            "pendingAmount": 86.87,
            "currency": "EUR",
            "links": [
                {
                    "rel": "self",
                    "href": "/booking/en/reference/1-4614587",
                    "method": "GET"
                },
                {
                    "rel": "bookingDetail",
                    "href": "/booking/en/reference/1-4614587",
                    "method": "GET"
                },
                {
                    "rel": "bookingCancel",
                    "href": "/booking/en/reference/1-4614587",
                    "method": "DELETE"
                }
            ]
        }
    ]
}

Post Booking Operations

Once you have confirmed bookings, there's a series of operations that can be performed:

  • BookingDetail: To retrieve the information of a specific booking.
  • BookingCancellation: To cancel a booking.

Bear in mind that you will need the booking reference of the bookings you carried out to perform this operation