Update

What it does: Modifies an existing booking using a two-step preview-then-commit flow.

When to call it: Before the booking's FromDate has passed.

Restrictions

To change the customer's email address, use UpdateCustomer.

What can be updated

• Rental duration (ToDate relative to FromDate).
• Cover amount (VehicleStdLiabilityLow / VehicleStdLiabilityHigh).
• Customer details (FirstName, LastName, CustomerAge, Address1/2, City, Region, PostalCode, Phone).
• Vehicle information (VehicleNettPrice).

POST /insurances/update/<reference>

Two-step flow

Step 1. Preview (QuoteOnly: 1): Returns the updated price without saving anything. Present the price difference to the customer before proceeding.

curl -i -X POST \
  -H "X_API_KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "QuoteOnly": 1,
    "FromDate": "2025-08-01 00:00:00",
    "ToDate": "2025-08-10 00:00:00",
    "FirstName": "Jane",
    "LastName": "Smith",
    "Email": "[email protected]",
    "Country": "US"
  }' \
  https://api-staging.rentalcover.com/insurances/update/AB12-345C-INS

Step 2. Commit (QuoteOnly: 0): Applies the change. RentalCover automatically refunds or charges the difference to the original card.

curl -i -X POST \
  -H "X_API_KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "QuoteOnly": 0,
    "FromDate": "2025-08-01 00:00:00",
    "ToDate": "2025-08-10 00:00:00",
    "FirstName": "Jane",
    "LastName": "Smith",
    "Email": "[email protected]",
    "Country": "US"
  }' \
  https://api-staging.rentalcover.com/insurances/update/AB12-345C-INS

Request parameters

Update accepts fields from Group A, Group B, Group D, and Group F. Include only the fields you want to change, omitted fields remain unchanged.

Update-specific parameter

Required.

Parameter	Type	Description
QuoteOnly	boolean [0|1]	1 = preview (shows new price, saves nothing). 0 = commit the change. Always call step 1 first.

Email is accepted as an identifier but cannot be changed here. Use UpdateCustomer.

Response

Returns a Booking Response. In preview mode (QuoteOnly: 1), Status and pricing fields reflect the proposed change but nothing is saved. In commit mode (QuoteOnly: 0), the response confirms the applied change.