Documentation Instance Help

Get Availability

Get all available vehicle groups with their rates for the given request parameters. Here, the rateCode field is required in order to get a 200 response. Within the response of this endpoint, you will find for each product offering, a vendorRateID. This vendorRateID can then be used to create a reservation. The vehicle availability is not guaranteed and is checked again at the time of the reservation. The rates returned, are valid for 20 minutes. If surcharges like 'Out of Hours', 'Young Driver Surcharge' or 'One Way Surcharge' apply for the specific request, those will be included within the vehicleCharges. Each of those surcharges, will have an includedInRate and includedInEstTotalInd,to denote whether the extra is included in the rate or not.

POST method/v1/availability

Request parameters

{ "pickUpDateTime": "2001-06-07T05:52:04Z", "returnDateTime": "1987-09-27T18:08:16Z", "vehicleGroupsPrefAccriss": [ "MNAV" ], "vehicleGroupsPrefCode": [ "C1" ], "driverAge": 27, "returnExtras": false, "rateCode": "rateCode", "promotionCode": "promoMay", "mileagePolicy": "UNL", "pickUpLocationCode": "HER", "pickUpExtendedLocationCode": "HER01", "returnLocationCode": "HER", "returnExtendedLocationCode": "HER01" }

Responses

{ "pickupStationInfo": { "stationType": "Airport", "locationCode": "HER", "extendedLocationCode": "HER01", "name": "Heraklion airport", "address": { "addressLine": [ "Herakleion Airport Nikos Kazantzakis", "(25.1747,35.3396)" ], "city": "Herakleion", "postalCode": "71408", "country": { "code": "GR", "name": "Greece" }, "coordinates": { "latitude": 25.1747, "longitude": 35.3396 } }, "telephone": "example", "additionalInfo": { "text": "The customer will walk to the parking lot, 50 meters opposite from the airport building and then he will be transferred to our office, which is 700 meters away, with shuttle bus.", "operationTime": [ { "days": [ "Monday", "Tuesday" ], "schedule": { "normal": { "start": "10:00:00", "end": "18:16:40" }, "extended": { "start": "18:33:20", "end": "01:00:00" } } } ] } }, "returnStationInfo": { "stationType": "Airport", "locationCode": "HER", "extendedLocationCode": "HER01", "name": "Heraklion airport", "address": { "addressLine": [ "Herakleion Airport Nikos Kazantzakis", "(25.1747,35.3396)" ], "city": "Herakleion", "postalCode": "71408", "country": { "code": "GR", "name": "Greece" }, "coordinates": { "latitude": 25.1747, "longitude": 35.3396 } }, "telephone": "example", "additionalInfo": { "text": "The customer will walk to the parking lot, 50 meters opposite from the airport building and then he will be transferred to our office, which is 700 meters away, with shuttle bus.", "operationTime": [ { "days": [ "Monday", "Tuesday" ], "schedule": { "normal": { "start": "10:00:00", "end": "18:16:40" }, "extended": { "start": "18:33:20", "end": "01:00:00" } } } ] } }, "productOfferings": [ { "vehicle": { "airConditionInd": true, "code": "MNAV", "description": "Fiat 500 cabrio or similar", "passengerQuantity": 4, "transmissionType": "Automatic", "vendorCarType": "ASE", "vehMakeModel": "Economy", "pictureURL": "", "doorsNum": 4, "suitcasesNum": 4, "minDriverAge": 20, "maxDriverAge": 99, "youngDriverAge": 23, "insuranceExcess": 1000, "insuranceDeposit": 0, "sippCategoryId": "I", "sippTypeId": "V", "sippTransmissionId": "M", "sippFuelId": "R" }, "rentalDetails": [ { "rentalRate": { "rateQualifier": { "rateCode": "stations", "promotionCode": "promoMay", "vendorRateID": "6YEfMHCaCT" }, "mileagePolicy": { "distUnitName": "km", "unlimited": false, "vehiclePeriodUnitName": "per-day", "quantity": 100 }, "vehicleCharges": [ { "amount": ..., "currencyCode": ..., "description": ..., "detailedDescription": ..., "guaranteedInd": ..., "includedInEstTotalInd": ..., "includedInRate": ..., "purpose": ..., "taxInclusive": ..., "calculationInfo": ... } ], "includedExtras": [ { "amount": ..., "currencyCode": ..., "description": ..., "detailedDescription": ..., "allowQuantity": ..., "purpose": ..., "taxInclusive": ..., "calculationInfo": ... } ], "insurance": { "description": "CDW", "detailedDescription": "COLLISION DAMAGE WAIVER", "purpose": 7 }, "extras": [ { "amount": ..., "currencyCode": ..., "description": ..., "detailedDescription": ..., "allowQuantity": ..., "purpose": ..., "taxInclusive": ..., "calculationInfo": ... } ] }, "totalCharge": { "currencyCode": "EUR", "estimatedTotalAmount": 245.81, "rateTotalAmount": 245.81, "VAT": 67.35, "VATPercentage": 24 } } ] } ] }
{ "type": "3", "code": "320", "shortText": "Error message" }
{ "type": "3", "code": "320", "shortText": "Error message" }
{ "type": "3", "code": "320", "shortText": "Error message" }
{ "type": "3", "code": "320", "shortText": "Error message" }
{ "type": "3", "code": "320", "shortText": "Error message" }
Last modified: 07 August 2025