You can also request up to 20 multiple availabilities of different routes at same time if you need to request a full itinerary, or multiple routes at once.
POST https://api.test.hotelbeds.com/transfer-api/1.0/availability/routes/ {{language}} / {{adults}} / {{children}} / {{infants}}
POST https://api.test.hotelbeds.com/transfer-api/1.0/availability/routes/ {{language}} / {{adults}} / {{children}} / {{infants}} ? allowPartialResults= true/false &vehicle= {{vehicleCode}} &type= {{vehicleType}} &category= {{categoryCode}}
| Parameter | Type | Mandatory | Description |
| language | String | Y | Requested language code, mapping found in language codes |
| adults | Int | Y | Number of adult passengers (+18) |
| children | Int | Y | Number of child passengers (4~17) |
| infants | Int | Y | Number of infant passengers (0~3) |
| allowPartialResults | Boolean | N | if TRUE, return results even if one of the requested routes is not available |
| vehicle | String | N | OPTIONAL, vechicle code filter |
| type | String | N | OPTIONAL, type code filter |
| category | String | N | OPTIONAL, category code filter |
[
{
"id": "IATA-PMI-ATLAS-1523",
"dateTime": "2020-12-10T10:00:00"
},
{
"id": "ATLAS-1523-ATLAS-1067",
"dateTime": "2020-11-10T13:00:00"
},
{
"id": "ATLAS-1523-IATA-PMI",
"dateTime": "2020-11-10T20:00:00"
}
]{
"search": {
"language": "en",
"occupancy": {
"adults": 2,
"children": 1,
"infants": 0
},
"type": null,
"category": null,
"vehicle": null,
"routes": [
{
"id": "IATA-PMI-ATLAS-1523",
"dateTime": "2020-12-10T10:00:00"
},
{
"id": "ATLAS-1523-ATLAS-1067",
"dateTime": "2020-11-10T13:00:00"
},
{
"id": "ATLAS-1523-IATA-PMI",
"dateTime": "2020-11-10T20:00:00"
}
]
},
"routes": [
{
"id": "IATA-PMI-ATLAS-1523",
"date": "2020-12-10",
"time": "10:00:00",
"unfilteredTotalCount": 1,
"services": [
{
"id": 0,
"direction": "DEPARTURE",
"transferType": "PRIVATE",
"vehicle": {
"code": "CR",
"name": "Car"
},
"category": {
"code": "STND",
"name": "Standard product type"
},
"pickupInformation": {
"from": {
"code": "PMI",
"description": "Palma Majorca, Son Sant Joan Airport",
"type": "IATA"
},
"to": {
"code": "1523",
"description": "Visit Hotel Alexandra",
"type": "ATLAS"
},
"date": "2020-12-10",
"time": "10:00:00",
"pickup": {
"address": null,
"number": null,
"town": null,
"zip": null,
"description": "Once you have collected your luggage, proceed to the MTS GLOBE desk located in the arrivals hall in front of Gate D, and exit door 6. If you are unable to locate the driver/agent, please call MTS Globe Spain on 0034 871 170 564 /0034 670 561 784. Languages spoken at the call centre: English, Spanish. 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": 39.547654,
"longitude": 2.730388,
"checkPickup": {
"mustCheckPickupTime": false,
"url": null,
"hoursBeforeConsulting": null
},
"pickupId": 21445,
"stopName": "ARRIVALS HALL",
"image": null
}
},
"minPaxCapacity": 1,
"maxPaxCapacity": 4,
"content": {
"vehicle": {
"code": "CR",
"name": "Car"
},
"category": {
"code": "STND",
"name": "Standard"
},
"images": [
{
"url": "http://media.activitiesbank.com/giata/transfers/TRD/small/prvt-stnd-cr.png",
"type": "SMALL"
},
{
"url": "http://media.activitiesbank.com/giata/transfers/TRD/medium/prvt-stnd-cr.png",
"type": "MEDIUM"
},
{
"url": "http://media.activitiesbank.com/giata/transfers/TRD/large/prvt-stnd-cr.png",
"type": "LARGE"
},
{
"url": "http://media.activitiesbank.com/giata/transfers/TRD/extralarge/prvt-stnd-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": "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": "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": "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": "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, proceed to the MTS GLOBE desk located in the arrivals hall in front of Gate D, and exit door 6. If you are unable to locate the driver/agent, please call MTS Globe Spain on 0034 871 170 564 /0034 670 561 784. Languages spoken at the call centre: English, Spanish. 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\n* In the event of extra luggage or sport equipment being checked in, please contact us, as this may carry an extra charge.* In the event of being unable to locate the driver, please call the emergency number indicated in this voucher.* If the details do not correspond with the reservation, please contact your agency immediately.* 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.* 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.* 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* 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.\n\n* Exclusive ride for you* Door to door service* 1 piece of baggage allowed per person ( max.dimensions 158cm) length+width+height=158cm* 1 item of hand baggage allowed per person\n\n",
"mandatory": true
}
]
},
"price": {
"totalAmount": 45.73,
"netAmount": 40.24,
"currencyId": "AUD"
},
"rateKey": "ARRIVAL|IATA|PMI|ATLAS|1523|2020-12-10|10:00|2020-12-10|10:00|2~1~0|4|112752|PMI PRV STD MTS|112752|PMI PRV STD MTS|1|PRVT|C|CR|STND|45.73|AEROPUERTO|CPASTILLA|21445|2211|PMI|ROUTE|d5d71257a59de837bc24b9bd73fd2037",
"cancellationPolicies": [
{
"amount": 45.73,
"from": "2020-12-09T00:00:00",
"currencyId": "AUD"
}
],
"links": [
{
"rel": "self",
"href": "/availability",
"method": "GET"
},
{
"rel": "confirm",
"href": "/booking",
"method": "POST"
}
],
"factsheetId": 2211
}
]
},
{
"id": "ATLAS-1523-ATLAS-1067",
"date": "2020-11-10",
"time": "13:00:00",
"unfilteredTotalCount": 0,
"services": []
},
{
"id": "ATLAS-1523-IATA-PMI",
"date": "2020-11-10",
"time": "20:00:00",
"unfilteredTotalCount": 1,
"services": [
{
"id": 0,
"direction": "DEPARTURE",
"transferType": "PRIVATE",
"vehicle": {
"code": "CR",
"name": "Car"
},
"category": {
"code": "STND",
"name": "Standard product type"
},
"pickupInformation": {
"from": {
"code": "1523",
"description": "Visit Hotel Alexandra",
"type": "ATLAS"
},
"to": {
"code": "PMI",
"description": "Palma Majorca, Son Sant Joan Airport",
"type": "IATA"
},
"date": "2020-11-10",
"time": "17:40:00",
"pickup": {
"address": "DELS PINS,15 ",
"number": null,
"town": "CAN PASTILLA",
"zip": "07610",
"description": "You will be picked up outside the hotel entrance. If you are unable to locate the driver/agent, please call MTS Globe Spain on 0034 871 170 564 / 0034 670 561 784. Languages spoken at the call centre: English, Spanish. 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": 39.5362,
"longitude": 2.71746,
"checkPickup": {
"mustCheckPickupTime": false,
"url": null,
"hoursBeforeConsulting": null
},
"pickupId": 21444,
"stopName": "OUTSIDE HOTEL",
"image": null
}
},
"minPaxCapacity": 1,
"maxPaxCapacity": 4,
"content": {
"vehicle": {
"code": "CR",
"name": "Car"
},
"category": {
"code": "STND",
"name": "Standard"
},
"images": [
{
"url": "http://media.activitiesbank.com/giata/transfers/TRD/small/prvt-stnd-cr.png",
"type": "SMALL"
},
{
"url": "http://media.activitiesbank.com/giata/transfers/TRD/medium/prvt-stnd-cr.png",
"type": "MEDIUM"
},
{
"url": "http://media.activitiesbank.com/giata/transfers/TRD/large/prvt-stnd-cr.png",
"type": "LARGE"
},
{
"url": "http://media.activitiesbank.com/giata/transfers/TRD/extralarge/prvt-stnd-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": "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": "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"
}
],
"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 outside the hotel entrance. If you are unable to locate the driver/agent, please call MTS Globe Spain on 0034 871 170 564 / 0034 670 561 784. Languages spoken at the call centre: English, Spanish. 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\n* In the event of extra luggage or sport equipment being checked in, please contact us, as this may carry an extra charge.* In the event of being unable to locate the driver, please call the emergency number indicated in this voucher.* If the details do not correspond with the reservation, please contact your agency immediately.* 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\n* Exclusive ride for you* Door to door service* 1 piece of baggage allowed per person ( max.dimensions 158cm) length+width+height=158cm* 1 item of hand baggage allowed per person\n\n",
"mandatory": true
}
]
},
"price": {
"totalAmount": 45.73,
"netAmount": 40.24,
"currencyId": "AUD"
},
"rateKey": "DEPARTURE|ATLAS|1523|IATA|PMI|2020-11-10|17:40|2020-11-10|20:00|2~1~0|4|112752|PMI PRV STD MTS|112752|PMI PRV STD MTS|1|PRVT|C|CR|STND|45.73|CPASTILLA|AEROPUERTO|21444|2211|PMI|ROUTE|bf0f225cbf237117abbe2c1264bc415d",
"cancellationPolicies": [
{
"amount": 45.73,
"from": "2020-11-09T00:00:00",
"currencyId": "AUD"
}
],
"links": [
{
"rel": "self",
"href": "/availability",
"method": "GET"
},
{
"rel": "confirm",
"href": "/booking",
"method": "POST"
}
],
"factsheetId": 2211
}
]
}
]
}