Documentation Instance Help

Amend a Reservation

PUT method/v1/reservation/{orderId}/amend

This endpoint allows you to amend certain details of an existing reservation.

Important notes:

  • Changing the pickup or return station is not accepted. If you wish to change the station, you must cancel the current reservation and create a new one.

  • If you change the pickup/return dates, vehicle group preference, customer age, or mileage policy, the system will internally call the availability service. This may result in:

    • No availability for the new criteria (the amendment will fail with an error)

    • A change in the rate/price of the order (the new rate will be applied)

  • If the availability service is called due to such changes, the amended order will be set to pending status. You must then commit the order to finalize the reservation.

  • If only non-critical fields are changed (e.g., notes, flight number), the order remains in its current status.

Please review the response for any required follow-up actions after amending a reservation.

Request parameters

{ "pickUpDateTime": "2001-06-07T05:52:04Z", "returnDateTime": "1987-09-27T18:08:16Z", "pickUpLocationCode": "HER", "pickUpExtendedLocationCode": "HER01", "returnLocationCode": "HER", "returnExtendedLocationCode": "HER01", "vehicleGroupPrefAccriss": "MNAV", "flightNo": "example", "arrivalDatetime": "2005-10-14T16:47:11Z", "notes": "test notes", "customerInfo": { "customer": { "name": "john carminati", "email": "777362@booking.happycar.click", "phone": "+306944444444", "addressLine": "Ikarou 48", "city": "Herakleion", "country": "GR", "postalCode": "71309", "dateOfBirth": "Fri Apr 26 03:00:00 EEST 1985", "driverLicenseNumber": "12312AD", "driverLicenseCountryId": "GR", "driverLicenseIssueDate": "Mon Jan 02 02:00:00 EET 2023", "driverLicenseExpirationDate": "Mon Jan 02 02:00:00 EET 2023" }, "corporateCustomer": { "company": "rous", "country": "GR", "vatNumber": "122611214", "addressLine": "test address", "phone": "+3069116223324", "email": "rousakis@gmail.com" }, "additionalDrivers": [ { "name": "TESTA TESTUSERA", "dateOfBirth": "Fri Apr 26 03:00:00 EEST 1985", "driverLicenseNumber": "12312AD", "driverLicenseCountryId": "GR", "driverLicenseIssueDate": "Mon Jan 02 02:00:00 EET 2023", "driverLicenseExpirationDate": "Mon Jan 02 02:00:00 EET 2023" } ], "additionalUnknownDriversNum": 2 }, "specialEquipmentPreferences": [ { "equipType": 15, "quantity": 1 } ], "coveragePreferences": [ { "coverageType": 39 } ] }

Responses

{ "orderInfo": { "id": "e8632507-94db-490f-b60f-070834ffce54", "corporateOrderId": 824, "brokerOrderId": "ZeiSD6nhQo", "status": "confirmed", "reservationDate": "1998-12-23T20:39:07Z", "franchisee": "Rental Car Herakleion", "pickUpDateTime": "2001-06-07T05:52:04Z", "returnDateTime": "1987-09-27T18:08:16Z", "notes": "test notes", "flightNo": "AE50394" }, "pickUpLocation": { "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" } } } ] } }, "returnLocation": { "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" } } } ] } }, "customerInfo": { "customer": { "name": "carminati2", "email": "777362@booking.happycar.click" }, "additionaldrivers": [ { "name": "TESTUSER" } ] }, "vehicleInfo": { "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" }, "pricedEquips": [ { "VehicleCharge": { "amount": 213.12, "currencyCode": "EUR", "description": "Product Cost", "detailedDescription": "", "guaranteedInd": true, "includedInEstTotalInd": true, "includedInRate": true, "purpose": 1, "taxInclusive": true, "calculationInfo": { "quantity": 4, "unitCharge": 53.28, "unitName": "Rental" } } } ], "pricedCoverages": [ { "VehicleCharge": { "amount": 213.12, "currencyCode": "EUR", "description": "Product Cost", "detailedDescription": "", "guaranteedInd": true, "includedInEstTotalInd": true, "includedInRate": true, "purpose": 1, "taxInclusive": true, "calculationInfo": { "quantity": 4, "unitCharge": 53.28, "unitName": "Rental" } } } ], "rentalRate": { "mileagePolicy": { "distUnitName": "km", "unlimited": false, "vehiclePeriodUnitName": "per-day", "quantity": 100 }, "vehicleCharges": [ { "amount": 213.12, "currencyCode": "EUR", "description": "Product Cost", "detailedDescription": "", "guaranteedInd": true, "includedInEstTotalInd": true, "includedInRate": true, "purpose": 1, "taxInclusive": true, "calculationInfo": { "quantity": 4, "unitCharge": 53.28, "unitName": "Rental" } } ] }, "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" }
Last modified: 07 August 2025