Get transfers for booking
POST
/v1/getTransfers
Request
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://api.ygo.ai/v1/v1/getTransfers' \
--header 'Content-Type: application/json' \
--data-raw '{
"BookingID": "BK-2025-ABC123"
}'Response Response Example
200 - Booking with available transfer options
{
"Data": {
"Options": [
{
"Provider": "HBX",
"Brand": "HBX",
"Name": "Private Transfer - Mercedes E-Class",
"Description": "Luxurious private transfer with professional driver. Includes flight monitoring, meet & greet service, and complimentary water.",
"Direction": "ARRIVAL",
"Price": {
"Amount": 65,
"Currency": "EUR"
},
"TransferType": "private",
"RateKey": "TRF-2025-PVT-001",
"MinPaxCapacity": 1,
"MaxPaxCapacity": 3,
"Images": [
{
"URL": "https://cdn.peakwork.com/transfers/mercedes-eclass.jpg",
"Type": "vehicle"
}
],
"PickupInformation": {
"From": {
"Type": "AIRPORT",
"Code": "BCN",
"Description": "Barcelona El Prat Airport - Terminal 1, Arrivals Hall"
},
"To": {
"Type": "ATLAS",
"Code": "123456",
"Description": "Hotel Arts Barcelona"
},
"Date": "2025-11-15",
"Time": "10:45",
"Pickup": {
"Description": "Driver will wait at Arrivals Hall with name sign",
"Latitude": 41.2974,
"Longitude": 2.0833,
"CheckPickup": {
"MustCheckPickupTime": true
}
}
},
"TransferRemarks": [
{
"Type": "IMPORTANT",
"Description": "Please provide mobile number for driver contact",
"Mandatory": true
},
{
"Type": "INFO",
"Description": "Maximum 2 large suitcases per vehicle",
"Mandatory": false
}
],
"CancellationPolicies": [
{
"Amount": 65,
"From": "2025-11-14T00:00:00Z",
"CurrencyID": "EUR",
"IsForceMajeure": false
},
{
"Amount": 0,
"From": "2025-11-01T00:00:00Z",
"CurrencyID": "EUR",
"IsForceMajeure": false
}
]
},
{
"Provider": "Peakwork",
"Brand": "Peakwork",
"Name": "Shared Shuttle Service",
"Description": "Economical shared shuttle with other travelers. Multiple hotel stops en route.",
"Direction": "ARRIVAL",
"Price": {
"Amount": 18,
"Currency": "EUR"
},
"TransferType": "shuttle",
"RateKey": "TRF-2025-SHT-002",
"MinPaxCapacity": 1,
"MaxPaxCapacity": 8,
"PickupInformation": {
"From": {
"Type": "AIRPORT",
"Code": "BCN",
"Description": "Barcelona El Prat Airport - Shuttle Bus Stop 3"
},
"To": {
"Type": "ATLAS",
"Code": "123456",
"Description": "Hotel Arts Barcelona"
},
"Date": "2025-11-15",
"Time": "11:15"
},
"TransferRemarks": [
{
"Type": "INFO",
"Description": "Shuttle departs every 30 minutes. Travel time may vary based on number of stops.",
"Mandatory": false
}
],
"CancellationPolicies": [
{
"Amount": 18,
"From": "2025-11-13T00:00:00Z",
"CurrencyID": "EUR",
"IsForceMajeure": false
}
]
},
{
"Provider": "SunnyCars",
"Brand": "SunnyCars",
"Name": "Private Transfer - Mercedes E-Class",
"Description": "Luxurious private transfer with professional driver. Includes flight monitoring and complimentary water.",
"Direction": "DEPARTURE",
"Price": {
"Amount": 65,
"Currency": "EUR"
},
"TransferType": "private",
"RateKey": "TRF-2025-PVT-003",
"MinPaxCapacity": 1,
"MaxPaxCapacity": 3,
"PickupInformation": {
"From": {
"Type": "ATLAS",
"Code": "123456",
"Description": "Hotel Arts Barcelona"
},
"To": {
"Type": "AIRPORT",
"Code": "BCN",
"Description": "Barcelona El Prat Airport - Terminal 1"
},
"Date": "2025-11-22",
"Time": "15:45",
"Pickup": {
"Description": "Driver will collect from hotel lobby 3 hours before flight",
"Latitude": 41.3851,
"Longitude": 2.1964,
"CheckPickup": {
"MustCheckPickupTime": true
}
}
},
"TransferRemarks": [
{
"Type": "IMPORTANT",
"Description": "Please be ready at hotel lobby 15 minutes before scheduled pickup",
"Mandatory": true
}
],
"CancellationPolicies": [
{
"Amount": 65,
"From": "2025-11-21T00:00:00Z",
"CurrencyID": "EUR",
"IsForceMajeure": false
}
]
}
],
"Success": true
},
"Error": null
}Modified at 2025-10-16 13:29:55