Documentation
Dashboard Menu
This new API capability enables minor amendments to transfer bookings, allowing updates to lead passenger details, arrival and departure information, pickup time, and origin/destination hotel, without any cost for the final client.
When an amendment request cannot be processed due to system limitations, or if it results in a price increase, an error message E_BOOKING_MODIFICATIONERROR will be returned. In such cases, you will need to cancel and rebook the service.
Please check the Transfers API errors to review the new documentation related to amendment errors here.
Endpoint:
PUT https://api.hotelbeds.com/transfer-api/1.0/booking
Note:It is used the same BOOKING endpoint, but accesing via PUT instead of POST.
Pleases note that the bellow amendments can be combined indepently among them in case it was necessary.
Bear also in mind that the field "language" will display the response in the language requested, and it could be different from the one used in the confirmation.
Amend holder details
This is the structure that have to be used in order to update the lead passenger (holder) details of a transfer booking.
The holder object supports partial updates, meaning that only the fields to be modified need to be included in the request. Any fields not provided will remain unchanged with the original value.
RQ
{
"reference": "XXX-YYYYYYY",
"language": "en",
"holder": {
"name": "John",
"surname": "Doe",
"email": "johndoe@hotelbeds.com",
"phone": "+451122334455"
}
}
Amend transfer details
This endpoint allows updating the details of a specific transfer service within a booking. All fields must be provided, including the transfer ID to be amended, even in single-service bookings.
Validation rules:
- The type and direction must match the original values and cannot be modified.
- Fields such as transferDateTime, code, and companyName can be updated.
Important considerations:
- The pick-up time must be checked after any amendment, as it will be automatically recalculated based on the updated arrival or departure information.
RQ
{
"reference": "XXX-YYYYYYY",
"language": "en",
"transfers": [
{
"id": 1,
"transferDetails": [
{
"transferDateTime": "2030-07-01T14:00:00",
"type": "FLIGHT",
"direction": "ARRIVAL",
"code": "XR1234",
"companyName": "IBERIA"
}
]
}
]
}Amend Pickup Time
(Departure Private Transfers Only)
For Departure Private transfers only, a custom pick-up time can be provided to adjust the passenger’s waiting time at the destination (either reducing or extending it). However, this practice is not recommended. Clients are strongly advised to use the system pre-calculated pick-up time.
If a custom pick-up time is used, it is applied at the client’s own risk, and no guarantee can be provided that the passenger will arrive at the departure point on time.
EXCEPTIONS:
- For services involving cruise terminals (even if they are ARRIVAL services) the original arrival and departure times are already considered the pick-up times, therefore to amend the them, exclusively use the Amend Pickup Time not the Transfer Details amend.
- Same thing happens for the route train station (STATION) to airport (IATA), any time changes must be handled exclusively through a pick-up amendment request, not via the amend transfer details functionality.
Relation of routes that have to be changed exclusively by Amend Pickup Time
Port-Hotel
Port-Airport
Hotel-Port
Train-Airport
RQ
{
"reference": "XXX-YYYYYYYY",
"language": "en",
"transfers": [
{
"id": 1,
"pickupTime": "2030-10-13T12:00"
}
]
}Amend Acommodation Arrival or Departure
(Only applicable to geodata (GPS) transfer bookings not Atlas code)
The API also allows amendments to the arrival or departure hotel. To perform this change, you must provide detailed information about the new origin or destination, using the same structure required for geodata searches (see fields requested below).
All elements included in the examples must be present in the request, even if the information remains unchanged.
Disclaimer: This call does not recalculate the service price; it only updates the location. If the new hotel is outside the original area, the price may need to be adjusted. Use this call only if the new hotel is close to the original one; otherwise, please cancel and rebook.
Arrival Acommodation (Terminal - Hotel)
RQ
{
"reference": "XXX-YYYYYYY",
"language": "en",
"transfers": [
{
"id": 1,
"dropoffInformation": {
"name": "test",
"address": "c/testing street",
"town": "Palma",
"country": "Spain",
"zip": "07015"
}
}
]
}Departure Acommodation (Hotel - Terminal)
RQ
{
"reference": "XXX-YYYYYYYY",
"language": "en",
"transfers": [
{
"id": 1,
"pickupInformation": {
"name": "test",
"address": "c/testing street",
"town": "palma",
"country": "España",
"zip": "07015"
}
}
]
}Amendment examples
Changing holder information.
Original Booking was
{
"language": "es",
"holder": {
"title": "Mr",
"name": "John",
"surname": "Doe",
"email": "john.doe@hotelbeds.com",
"phone": "+16543245812"
},
"transfers
RQ
{
"reference": "102-20964482",
"language": "en",
"holder": {
"name": "Juan",
"surname": "Pérez",
"email": "juanperez@hs.com",
"phone": "+855894118"
}
}Rs
{
"bookings": [
{
"reference": "102-20964482",
"bookingFileId": null,
"creationDate": "2026-06-26T10:39:53",
"status": "CONFIRMED",
"modificationsPolicies": {
"cancellation": true,
"modification": true,
"confirmation": false
},
"holder": {
"name": "Juan",
"surname": "Pérez",
"email": "juanperez@hs.com",
"phone": "+855894118"
},
"transfers": [
{
"id": 1,
"status": "CONFIRMED",
"transferType": "PRIVATE",
"vehicle": {
"code": "CR",
"name": null
},
"category": {
"code": "PRM",
"name": nullChanging TransferDetails (Flight) and the pickup time.
Original Transfer Detail:
"transferDetails": [
{
"type": "FLIGHT",
"direction": "DEPARTURE",
"code": "XR1234",
"companyName": null
}
Original pre-calculate pick-up time:
"date": "2026-08-30",
"time": "10:40:00",
RQ
{
"reference": "102-20964488",
"language": "en",
"transfers": [
{
"id": 1,
"pickupTime": "2026-10-10T12:00"
"transferDetails": [
{
"transferDateTime": "2026-07-22T14:00:00",
"type": "FLIGHT",
"direction": "DEPARTURE",
"code": "X1234",
"companyName": "SPACE" }
]
}
]
}RS:
"pickupInformation": {
"from": {
"code": "57",
"description": null,
"type": "ATLAS",
"typeEnum": "ATLAS"
},
"to": {
"code": "BCN",
"description": null,
"type": "IATA",
"typeEnum": "IATA"
},
"date": "2026-07-22",
"time": "12:00:00",
-----------------------------------------------------
"transferDetails": [
{
"type": "FLIGHT",
"direction": "DEPARTURE",
"code": "X1234",
"companyName": null
}
],Amend Holder + Original and Departure Hotel
Original holder information
"holder": {
"title": "Mr",
"name": "John",
"surname": "Doe",
"email": "john.doe@hotelbeds.com",
"phone": "+16543245812"
Original pickup & dopoff Information
"name": " Olivia Balmes Hotel",
"address": "Carrer de Balmes, 117, 99, Eixample",
"town": "Barcelona",
"country": "ES",
"zip": "08008 "
RQ
{
"reference": "102-20982115",
"language": "en",
"holder": {
"name": "Juan",
"surname": "Garcia",
"email": "juangarcia@mailbox.com",
"phone": "+51111111111"
},
"transfers": [
{
"id": 1,
"dropoffInformation": {
"name": "H10 Art Gallery",
"address": "Carrer d'Enric Granados",
"town": "Barcelona",
"country": "España",
"zip": "08008"
}
},
{
"id": 2,
"pickupInformation": {
"name": "H10 Art Gallery",
"address": "Carrer d'Enric Granados",
"town": "Barcelona",
"country": "España",
"zip": "08008"
}
}
]
}RS
{
"bookings": [
{
"reference": "102-20982115",
"bookingFileId": null,
"creationDate": "2026-06-29T14:35:36",
"status": "CONFIRMED",
"modificationsPolicies": {
"cancellation": true,
"modification": true,
"confirmation": false
},
"holder": {
"name": "Juan",
"surname": "Garcia",
"email": "juangarcia@mailbox.com",
"phone": "+51111111111"
}
----------------------------------------
"code": "41.39,2.16",
"description": "H10 Art Gallery, Carrer d'Enric Granados, 08008 Barcelona, España",
"type": "GPS",
"typeEnum": "GPS"