Documentation

{
  "language": "en",
    "holder": {
        "name": "John",
        "surname": "Doe",
        "email": "john.doe@hotelbeds.com",
        "phone": "+16543245812"
    },
    "transfers": [
        {
            "rateKey": "ARRIVAL|IATA|BCN|ATLAS|57|2026-05-08|10:00|2026-05-08|10:00|2~0~0||3|||||102|PRVT||CR|STND|37.35||||43|57|SIMPLE|a1f662fd31f7b2b2da13f2c08487037a|1444356|T|bfmghpcvn9jkxqcwnsfsbpn4|2026-02-03|12:40",
            "transferDetails": [
              {
                "type": "FLIGHT",
                "direction": "ARRIVAL",
                "code": "XR1234",
                "companyName": "AirCompany"
              }
          ]
        }
    ],
    
    "clientReference": "Agency reference",
    "welcomeMessage": "Welcome Mr. John Doe",
    "remark": "Remarks go here."
}

{
    "language": "es",
    "holder": {
        "name": "John",
        "surname": "Doe",
        "email": "john.doe@hotelbeds.com",
        "phone": "+16543245812"
    },
    "transfers": [
        {
            "rateKey": "ARRIVAL|IATA|BCN|ATLAS|57|2026-05-08|10:00|2026-05-08|10:00|2~0~0||3|||||102|PRVT||CR|STND|37.35||||43|57|SIMPLE|a1f662fd31f7b2b2da13f2c08487037a|1444356|T|bfmghpcvn9jkxqcwnsfsbpn4|2026-02-03|12:57",
            "transferDetails": [
            	{
            		"type": "FLIGHT",
            		"direction": "ARRIVAL",
            		"code": "XR1234",
            		"companyName": "AirCompany"
            	}
        	]
        },
        {
            "rateKey": "DEPARTURE|ATLAS|57|IATA|BCN|||2026-05-09|11:00|2~0~0||99|||||102|SHRD||SH|PRM|29.20||||519|BCN|SIMPLE|7d160a8a77215761f7a1001838fcc812|1396869|T|bfmghpcvn9jkxqcwnsfsbpn4|2026-02-03|12:57",
            "transferDetails": [
            	{
            		"type": "FLIGHT",
            		"direction": "DEPARTURE",
            		"code": "XR1234",
            		"companyName": "AirCompany"
            	}
        	]
        }
    ],
    "clientReference": "Agency reference",
    "welcomeMessage": "Welcome Mr. John Doe",
    "remark": "Remarks go here."
}

{
  "bookings": [
    {
      "reference": "102-20100194",
      "bookingFileId": null,
      "creationDate": "2026-02-03T12:54:52",
      "status": "CONFIRMED",
      "modificationsPolicies": {
        "cancellation": true,
        "modification": true
      },
      "holder": {
        "name": "John",
        "surname": "Doe",
        "email": "john.doe@hotelbeds.com",
        "phone": "+16543245812"
      },
      "transfers": [
        {
          "id": 1,
          "rateKey": "ARRIVAL|IATA|BCN|ATLAS|57|2026-05-08|10:00|2026-05-08|10:00|2~0~0||3|||||102|PRVT||CR|STND|37.35||||43|57|SIMPLE|a1f662fd31f7b2b2da13f2c08487037a|1444356|T|bfmghpcvn9jkxqcwnsfsbpn4|2026-02-03|12:40",
          "status": "CONFIRMED",
          "transferType": "PRIVATE",
          "vehicle": {
            "code": "CR",
            "name": "Car"
          },
          "category": {
            "code": "STND",
            "name": "Standard"
          },
          "pickupInformation": {
            "from": {
              "code": "BCN",
              "description": "Barcelona Airport",
              "type": "IATA",
              "typeEnum": "IATA"
            },
            "to": {
              "code": "57",
              "description": "Barcelona Universal",
              "type": "ATLAS",
              "typeEnum": "ATLAS"
            },
            "date": "2026-05-08",
            "time": "10:00:00",
            "pickup": {
              "address": null,
              "number": null,
              "town": null,
              "zip": null,
              "description": "Supplier Name: MyTransfers - Spain, Supplier Emergency Contact Phone: +34 911880435 / +1 8449561190 /  WhatsApp (Text Only): +1 8449561190 .\n\n\nFINDING YOUR DRIVER\nPlease proceed to the meeting area in your terminal, where your driver/representative will be waiting holding a sign with your name on it.\n\nTerminal 1: Right after baggage claim, proceed to the drivers waiting area located near the Go Natural Cafe.\nTerminal 2: Right after baggage claim, please proceed to the arrivals hall.\n\nIdentify yourself by showing your voucher to the Supplier, for whom we act as a booking agent.\n\nImportant note: Your driver will arrive at the airport 15 minutes AFTER the flight has landed, this is to allow the lengthy process of reaching the arrivals hall. Your driver will then wait for a maximum of a further 60 minutes upon their arrival if you have booked a Standard Service, and 75 min if you have booked a Premium Service. If you arrive before the 15 minutes, please contact the supplier on their office or emergency number below, advise that you are ready to be transferred and wait for the driver at the meeting point. \n\n\n\nIn the event of delays over 60 minutes on arrival you must call the supplier. There are 60 minutes wait time included from your flight landing/cruise disembarkation time/train arrival time.\n\nIF YOU CAN'T LOCATE YOUR DRIVER, please contact them directly by clicking on this link https://hbd.htxstaging.com.\nYou will need an internet or mobile phone connection to be able to call/message your driver.\n\nPlease don't attempt to contact your driver until you are at the agreed meeting point as, with the best intentions of providing you with the most efficient service, driver information is subject to change. If you are unable to locate your driver using CheckPickup, contact your supplier for assistance. Do not leave without having contacted your supplier using the details below first.\n\nDISCLAIMER HolidayTaxis Group Limited (part of HBX Group) processes your personal data for the purpose of providing you with contracted travel services. For more information about how we process your personal data, please refer to the Privacy Policy.You have the right to access, rectify, delete, and restrict the processing of your data, as well as other rights recognized by applicable law. You can exercise these rights by contacting us at dataprotection@holidaytaxis.com",
              "altitude": null,
              "latitude": 41.297475,
              "longitude": 2.083318,
              "checkPickup": {
                "mustCheckPickupTime": true,
                "url": "www.checkpickup.com",
                "hoursBeforeConsulting": 24
              },
              "pickupId": null,
              "stopName": null,
              "image": null
            }
          },
          "paxes": [
            {
              "type": "ADULT",
              "age": 30
            },
            {
              "type": "ADULT",
              "age": 30
            }
          ],
          "content": {
            "vehicle": {
              "code": "CR",
              "name": "Car"
            },
            "category": {
              "code": "STND",
              "name": "Standard"
            },
            "images": [
              {
                "url": "https://assets.htxstaging.com/imgs/default/vehicle_set/private.jpg",
                "type": "EXTRALARGE"
              },
              {
                "url": "https://assets.htxstaging.com/imgs/default/vehicle_set/private.jpg",
                "type": "LARGE"
              },
              {
                "url": "https://assets.htxstaging.com/imgs/default/vehicle_set/private.jpg",
                "type": "MEDIUM"
              },
              {
                "url": "https://assets.htxstaging.com/imgs/default/vehicle_set/private.jpg",
                "type": "SMALL"
              }
            ],
            "transferDetailInfo": [
              {
                "id": "TRFTIME",
                "name": "Transfer time",
                "description": "min. Estimated journey time",
                "type": "GENERAL_INFO",
                "value": "30"
              },
              {
                "id": "MINPAX",
                "name": "Minimum pax",
                "description": "passenger(s) minimum",
                "type": "GENERAL_INFO",
                "value": "1"
              },
              {
                "id": "MAXPAX",
                "name": "Maximum pax",
                "description": "passenger(s) maximum",
                "type": "GENERAL_INFO",
                "value": "3"
              },
              {
                "id": "LUGGAGE",
                "name": "Number of suitcases",
                "description": "suitcases permitted",
                "type": "GENERAL_INFO",
                "value": "3"
              }
            ],
            "customerTransferTimeInfo": [],
            "supplierTransferTimeInfo": [
              {
                "value": 60,
                "type": "SUPPLIER_MAX_WAITING_TIME",
                "metric": "minutes",
                "remarks": "In the event of delays over 60 minutes on arrival you must call the supplier. There are 60 minutes wait time included from your flight landing/cruise disembarkation time/train arrival time."
              }
            ],
            "transferRemarks": [
              {
                "type": "CONTRACT",
                "description": "Supplier Name: MyTransfers - Spain, Supplier Emergency Contact Phone: +34 911880435 / +1 8449561190 /  WhatsApp (Text Only): +1 8449561190 .\n\n\nFINDING YOUR DRIVER\nPlease proceed to the meeting area in your terminal, where your driver/representative will be waiting holding a sign with your name on it.\n\nTerminal 1: Right after baggage claim, proceed to the drivers waiting area located near the Go Natural Cafe.\nTerminal 2: Right after baggage claim, please proceed to the arrivals hall.\n\nIdentify yourself by showing your voucher to the Supplier, for whom we act as a booking agent.\n\nImportant note: Your driver will arrive at the airport 15 minutes AFTER the flight has landed, this is to allow the lengthy process of reaching the arrivals hall. Your driver will then wait for a maximum of a further 60 minutes upon their arrival if you have booked a Standard Service, and 75 min if you have booked a Premium Service. If you arrive before the 15 minutes, please contact the supplier on their office or emergency number below, advise that you are ready to be transferred and wait for the driver at the meeting point. \n\n\n\nIn the event of delays over 60 minutes on arrival you must call the supplier. There are 60 minutes wait time included from your flight landing/cruise disembarkation time/train arrival time.\n\nIF YOU CAN'T LOCATE YOUR DRIVER, please contact them directly by clicking on this link https://hbd.htxstaging.com.\nYou will need an internet or mobile phone connection to be able to call/message your driver.\n\nPlease don't attempt to contact your driver until you are at the agreed meeting point as, with the best intentions of providing you with the most efficient service, driver information is subject to change. If you are unable to locate your driver using CheckPickup, contact your supplier for assistance. Do not leave without having contacted your supplier using the details below first.\n\nDISCLAIMER HolidayTaxis Group Limited (part of HBX Group) processes your personal data for the purpose of providing you with contracted travel services. For more information about how we process your personal data, please refer to the Privacy Policy.You have the right to access, rectify, delete, and restrict the processing of your data, as well as other rights recognized by applicable law. You can exercise these rights by contacting us at dataprotection@holidaytaxis.com",
                "mandatory": true
              }
            ]
          },
          "price": {
            "totalAmount": 37.35,
            "transferAmount": 37.35,
            "extrasAmount": 0.00,
            "netAmount": null,
            "currencyId": "EUR"
          },
          "cancellationPolicies": [
            {
              "amount": 37.35,
              "from": "2026-05-07T00:00:00",
              "utcOffset": "+02:00",
              "currencyId": "EUR",
              "isForceMajeure": false
            }
          ],
          "factsheetId": 43,
          "arrivalFlightNumber": "XR1234",
          "departureFlightNumber": null,
          "arrivalShipName": null,
          "departureShipName": null,
          "arrivalTrainInfo": null,
          "departureTrainInfo": null,
          "transferDetails": [
            {
              "type": "FLIGHT",
              "direction": "ARRIVAL",
              "code": "XR1234",
              "companyName": null
            }
          ],
          "sourceMarketEmergencyNumber": "34971211630",
          "links": [
            {
              "rel": "transferCancel",
              "href": "/booking/en/reference/102-20100194",
              "method": "DELETE"
            }
          ],
          "vouchers": null
        }
      ],
      "clientReference": "AGENCIES REFERENCE",
      "remark": "",
      "invoiceCompany": {
        "code": "CH1"
      },
      "supplier": {
        "name": "HOTELBEDS SPAIN, S.L.U",
        "vatNumber": "ESB28916765"
      },
      "totalAmount": 37.35,
      "totalNetAmount": 37.35,
      "pendingAmount": 37.35,
      "currency": "EUR",
      "links": [
        {
          "rel": "self",
          "href": "/booking/en/reference/102-20100194",
          "method": "GET"
        },
        {
          "rel": "bookingDetail",
          "href": "/booking/en/reference/102-20100194",
          "method": "GET"
        },
        {
          "rel": "bookingCancel",
          "href": "/booking/en/reference/102-20100194",
          "method": "DELETE"
        }
      ],
      "paymentDataRequired": true
    }
  ]
}