# Update

The Update endpoint is used to fetch the updated policy assuming the `FromDate` has not yet passed. The update endpoint does not actually update the data on RentalCover server.

## **Allowed Updates**

* Duration (`ToDate` – `FromDate`)
* Cover amount (`VehicleStdLiabilityLow` / `VehicleStdLiabilityHigh`)
* Customer (`FirstName`, `LastName`, `CustomerAge`, `Address1`, `Address2`, `City`, `Region`, `PostalCode`, `Phone`)
* Vehicle infomation (`VehicleNettPrice`)

#### Endpoint: `/insurances/update`

#### Method: `POST`

{% tabs %}
{% tab title="POST /insurances/update " %}

```perl
curl -i -X POST \
-H "X_API_KEY: [my-api-key]" \
-H "Content-Type: application/json" \
-d '{"VehicleStdLiabilityLow":1000.00,"VehicleStdLiabilityHigh":5500.00,"FromDate":"2015-04-22 00:00:00","ToDate":"2015-04-23 00:00:00", "CustomerAge":21, "FirstName":"Jack", "LastName":"Smith","Email":"jacksmith@myemail.com.au","Country":"AU"}' \
https://api-staging.rentalcover.com/insurances/update/AB12-345C-INS
```

{% endtab %}

{% tab title="Response" %}

```graphql
{
   "BookingId":"12345",
   "Reference":"AB12-345C-INS",
   "Status":"PendingConfirm",
   "FromDate":"2015-03-19 00:00:00",
   "ToDate":"2015-03-22 00:00:00",
   "TotalAmount":60,
   "InsuranceCoverAmount":3000,
   "SupplierReference":null,
   "Expired":false,
   "CoveredDays":4,
   "Discount":0,
   "DestinationCountry":"Australia",
   "DestinationCountryObject":{
      "Code":"AU",
      "Name":"Australia",
      "PhoneCode":"+61"
   },
   "Currency":"AUD",
   "TotalAmountFormatted":"AU$60.00",
   "InsuranceCoverAmountFormatted":"AU$3,000.00",
   "DiscountFormatted":"AU$0.00",
   "DailyAmountFormatted":"AU$15.00",
   "Disclaimer":"By clicking the button above you accept website <a href=\"https:\/\/www.rentalcover.com\/terms\" target=\"_blank\">terms<\/a> & the policy provided by RentalCover.com. \r\n\tYou agree that these documents have been provided to you via the links and understand that you may print copies of them. You have noted the exclusions and limitations, which include passengers with existing medical conditions. You are authorised to buy travel insurance on behalf of all passengers in this booking, and all passengers meet the eligibility criteria. \r\n",
   "Policy":{
      "GapCoverAmount":"3500.00",
      "Name":"Zero Excess Rental Cover",
      "Type":"RoadsideAssistance",
      "Code":"RC001",
      "Excess":"0.00",
      "Inclusions":"<li>Rental vehicle excess cover: $AU$3,000.00 plus $3500 Free Gap Cover. Gap cover is sold free of charge with all RentalCover.com policies. You do not need to take the optional excess reduction at the depot as $AU$3,000.00 + $3500 is sufficient to cover your standard liability).<\/li><br\/><li>Important: While the rental company will charge your credit card for the damages (up to the standard liability) you would then make a claim to RentalCover.com.<\/li><br\/>As with all other RentalCover.com policies, this policy includes the following which are typically excluded by the rental companies:<br\/><li>Windscreen, tyre, roof &amp; underbody repairs.<\/li><br\/><li>Single vehicle accidents.<\/li><br\/><li>Hitting an animal.<\/li><br\/><li>Accidents after dusk.<\/li><br\/><li>Weather-related and water damage.<\/li><br\/><li>Key loss\/replacement.<\/li><br\/><li>Additional drivers that are nominated on the rental agreement<\/li><br\/><li>Demurrage (the supplier&#039;s lost rental while a vehicle is off the road for repairs).<\/li><br\/><li>Maximum claim: $3500.<\/li><br\/><li>Claim Fee: $0<\/li><br\/><li>Cost: Free with any RentalCover.com purchase!<\/li><br\/>Exclusions:<br\/>This cover does not cover the following events:<br\/><li>Does not cover damages sustained while driving on unsealed roads.<\/li><br\/><li>Does not cover damage caused where the terms of Rental Contract have been breached.<\/li><br\/><li>Does not cover damage caused by an event that leads to a police investigation.<\/li><br\/><li>Does not cover damage caused to the Vehicle in any way by part or total water submersion or salt water. * Damage caused to the Vehicle by the renter\u2019s wilful or negligent conduct or contravention of any legislation or regulation controlling vehicular traffic<\/li><br\/><li>Does not cover damage caused due to use of incorrect or contaminated fuel.<\/li><br\/>Where required, RentalCover.com will utilise the resources of the claims team that handled the original claim application (i.e. the primary RentalCover.com policy issuer) and will exercise their discretion.",
      "Description":"This policy covers payments that you make for damages\/repairs to any rental vehicle anywhere in Australia. There is nil excess payable on a claim (whereas the rental companies charge $330-$1000 if you take their &quot;reduced&quot; excess). You do not need the supplier&#039;s excess reduction (collision damage waiver), instead you pay the supplier for repairs and claim that &quot;excess cost&quot; from RentalCover.com. Covers all drivers on the rental agreement aged 19 to 75, for travel anywhere in Australia on the dates shown. Note that there may be a refundable bond charged to your credit card when you do not take the supplier&#039;s excess reduction (card fees may apply).",
      "SellingPoints":"<li>No exclusions!<\/li><br\/><li>Includes $3500 Free Gap Cover, free with any RentalCover.com purchase.<\/li><br\/><li>Includes single vehicle accidents<\/li><br\/><li>Includes windscreens &amp; tyre damage<\/li><br\/><li>Covers you if you hit an animal or if you are driving at night.<\/li>",
      "RoadsideAssistanceBlob":"NMC Freecall Hotline is 855-613-8252 or +1-469-941-5569. Emergencies On The Road: If your car requires towing due to one of these, follow the 5 steps below: key loss, a mechanical fault, smashed windscreen/headlights or an accident... <li>Call the rental company and let them know that you have your own roadside assistance provider that includes towing. They will advise the towing dropoff point, then;</li> <li>Call NMC (see above). You will need your RentalCover.com reference number (AB12-345C-INS).</li> <li>NMC will send a tow truck &amp; you will pay NMC whilst on the call.</li> <li>You will meet the tow truck &amp; go to the delivery point with them.</li> <li>Claim all the costs that you incurred via <a href='http://www.rentalcover.com/claims'>rentalcover.com/claims</a>. Our goal is to reimburse you within 7 days.</li> Otherwise, if you have locked your keys in the car or have a flat tyre, empty fuel tank or dead battery... ? You do not need to call the rental company. Just call NMC who will arrange a vehicle to perform repairs. You will pay NMC and any related costs would be claimed via <a href='http://www.rentalcover.com'>rentalcover.com/claims</a>.",
      "GapCoverAmountFormatted":"AU$3,500.00",
      "ExcessFormatted":"AU$0.00",
      "PdsUrl":false,
      "SupplierName":"RentalCover.com",
      "ModifyUrl":"http:\/\/www.rentalcover.com\/modify\/AB12-345C-INS",
      "CancelUrl":"http:\/\/www.rentalcover.com\/cancel\/AB12-345C-INS"
   },
   "Customer":{
      "FirstName":"Jack",
      "LastName":"Smith",
      "Email":"jacksmith@myemail.com.au",
      "Age":21,
      "Country":"AU"
   }
}{
   "BookingId":"12345",
   "Reference":"AB12-345C-INS",
   "Status":"PendingConfirm",
   "FromDate":"2015-03-19 00:00:00",
   "ToDate":"2015-03-22 00:00:00",
   "TotalAmount":60,
   "InsuranceCoverAmount":3000,
   "SupplierReference":null,
   "Expired":false,
   "CoveredDays":4,
   "Discount":0,
   "DestinationCountry":"Australia",
   "DestinationCountryObject":{
      "Code":"AU",
      "Name":"Australia",
      "PhoneCode":"+61"
   },
   "Currency":"AUD",
   "TotalAmountFormatted":"AU$60.00",
   "InsuranceCoverAmountFormatted":"AU$3,000.00",
   "DiscountFormatted":"AU$0.00",
   "DailyAmountFormatted":"AU$15.00",
   "Disclaimer":"By clicking the button above you accept website <a href=\"https:\/\/www.rentalcover.com\/terms\" target=\"_blank\">terms<\/a> & the policy provided by RentalCover.com. \r\n\tYou agree that these documents have been provided to you via the links and understand that you may print copies of them. You have noted the exclusions and limitations, which include passengers with existing medical conditions. You are authorised to buy travel insurance on behalf of all passengers in this booking, and all passengers meet the eligibility criteria. \r\n",
   "Policy":{
      "GapCoverAmount":"3500.00",
      "Name":"Zero Excess Rental Cover",
      "Type":"RoadsideAssistance",
      "Code":"RC001",
      "Excess":"0.00",
      "Inclusions":"<li>Rental vehicle excess cover: $AU$3,000.00 plus $3500 Free Gap Cover. Gap cover is sold free of charge with all RentalCover.com policies. You do not need to take the optional excess reduction at the depot as $AU$3,000.00 + $3500 is sufficient to cover your standard liability).<\/li><br\/><li>Important: While the rental company will charge your credit card for the damages (up to the standard liability) you would then make a claim to RentalCover.com.<\/li><br\/>As with all other RentalCover.com policies, this policy includes the following which are typically excluded by the rental companies:<br\/><li>Windscreen, tyre, roof &amp; underbody repairs.<\/li><br\/><li>Single vehicle accidents.<\/li><br\/><li>Hitting an animal.<\/li><br\/><li>Accidents after dusk.<\/li><br\/><li>Weather-related and water damage.<\/li><br\/><li>Key loss\/replacement.<\/li><br\/><li>Additional drivers that are nominated on the rental agreement<\/li><br\/><li>Demurrage (the supplier&#039;s lost rental while a vehicle is off the road for repairs).<\/li><br\/><li>Maximum claim: $3500.<\/li><br\/><li>Claim Fee: $0<\/li><br\/><li>Cost: Free with any RentalCover.com purchase!<\/li><br\/>Exclusions:<br\/>This cover does not cover the following events:<br\/><li>Does not cover damages sustained while driving on unsealed roads.<\/li><br\/><li>Does not cover damage caused where the terms of Rental Contract have been breached.<\/li><br\/><li>Does not cover damage caused by an event that leads to a police investigation.<\/li><br\/><li>Does not cover damage caused to the Vehicle in any way by part or total water submersion or salt water. * Damage caused to the Vehicle by the renter\u2019s wilful or negligent conduct or contravention of any legislation or regulation controlling vehicular traffic<\/li><br\/><li>Does not cover damage caused due to use of incorrect or contaminated fuel.<\/li><br\/>Where required, RentalCover.com will utilise the resources of the claims team that handled the original claim application (i.e. the primary RentalCover.com policy issuer) and will exercise their discretion.",
      "Description":"This policy covers payments that you make for damages\/repairs to any rental vehicle anywhere in Australia. There is nil excess payable on a claim (whereas the rental companies charge $330-$1000 if you take their &quot;reduced&quot; excess). You do not need the supplier&#039;s excess reduction (collision damage waiver), instead you pay the supplier for repairs and claim that &quot;excess cost&quot; from RentalCover.com. Covers all drivers on the rental agreement aged 19 to 75, for travel anywhere in Australia on the dates shown. Note that there may be a refundable bond charged to your credit card when you do not take the supplier&#039;s excess reduction (card fees may apply).",
      "SellingPoints":"<li>No exclusions!<\/li><br\/><li>Includes $3500 Free Gap Cover, free with any RentalCover.com purchase.<\/li><br\/><li>Includes single vehicle accidents<\/li><br\/><li>Includes windscreens &amp; tyre damage<\/li><br\/><li>Covers you if you hit an animal or if you are driving at night.<\/li>",
      "RoadsideAssistanceBlob":"NMC Freecall Hotline is 855-613-8252 or +1-469-941-5569. Emergencies On The Road: If your car requires towing due to one of these, follow the 5 steps below: key loss, a mechanical fault, smashed windscreen/headlights or an accident... <li>Call the rental company and let them know that you have your own roadside assistance provider that includes towing. They will advise the towing dropoff point, then;</li> <li>Call NMC (see above). You will need your RentalCover.com reference number (AB12-345C-INS).</li> <li>NMC will send a tow truck &amp; you will pay NMC whilst on the call.</li> <li>You will meet the tow truck &amp; go to the delivery point with them.</li> <li>Claim all the costs that you incurred via <a href='http://www.rentalcover.com/claims'>rentalcover.com/claims</a>. Our goal is to reimburse you within 7 days.</li> Otherwise, if you have locked your keys in the car or have a flat tyre, empty fuel tank or dead battery... ? You do not need to call the rental company. Just call NMC who will arrange a vehicle to perform repairs. You will pay NMC and any related costs would be claimed via <a href='http://www.rentalcover.com'>rentalcover.com/claims</a>.",
      "GapCoverAmountFormatted":"AU$3,500.00",
      "ExcessFormatted":"AU$0.00",
      "PdsUrl":false,
      "SupplierName":"RentalCover.com",
      "ModifyUrl":"http:\/\/www.rentalcover.com\/modify\/AB12-345C-INS",
      "CancelUrl":"http:\/\/www.rentalcover.com\/cancel\/AB12-345C-INS"
   },
   "Customer":{
      "FirstName":"Jack",
      "LastName":"Smith",
      "Email":"jacksmith@myemail.com.au",
      "Age":21,
      "Country":"AU"
   }
}
```

{% endtab %}
{% endtabs %}

## **Request Parameters**

<table><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><code>X_API_KEY</code> string [varchar(32)] <strong>required</strong></td><td>API Key, provided by RentalCover.com</td></tr><tr><td><code>QuoteOnly</code> boolean [0/1] <strong>required</strong></td><td>If set to <code>1</code> then returned update will not be saved. An additional update call with <code>0</code> parameter will be required if the update is to be saved. Typical user flow; user requests update with new details. System responds "For this update there will be [no charge | a refund of $x | a charge of $x]. Would you like to proceed?" Upon confirmation, the Update endpoint should be called again, with boolean set to <code>0</code>. Using tokenisation, the API will apply the refund, or charge to the original customer credit card.</td></tr><tr><td><code>FromDate</code> date [yyyy-mm-dd hh:mm:ss] <strong>required</strong></td><td>Date/time of vehicle pickup</td></tr><tr><td><code>ToDate</code> date [yyyy-mm-dd hh:mm:ss] <strong>required</strong></td><td>Date/time of vehicle dropoff</td></tr><tr><td><code>FirstName</code> string <strong>required</strong></td><td>Customer first name (if unknown use <code>NULL</code>)</td></tr><tr><td><code>LastName</code> string <strong>required</strong></td><td>Customer first name (if unknown use <code>NULL</code>)</td></tr><tr><td><code>Email</code> string <strong>required</strong></td><td>Customer email cannot be changed during update as Reference and Customer Email act as unique identifier. To update customer email, please use updateCustomer endpoint</td></tr><tr><td><code>Country</code> string [varchar(2)] <strong>required</strong></td><td>ISO 3166 two character country code for customer country of residence or IP</td></tr><tr><td><code>Currency</code> string [varchar(3)]</td><td>See Supported List of currencies</td></tr><tr><td><code>FromLocationName</code> string</td><td>City name of vehicle pickup</td></tr><tr><td><code>ToLocationName</code> string</td><td>City name of vehicle drop off</td></tr><tr><td><code>Address1</code> string</td><td>Customer street address line 1 (50 character limit)</td></tr><tr><td><code>Address2</code> string</td><td>Customer street address line 2 (50 character limit)</td></tr><tr><td><code>City</code> string</td><td>Customer suburb</td></tr><tr><td><code>PostalCode</code> string</td><td>Customer postcode or zip code</td></tr><tr><td><code>Phone</code> string</td><td>Customer phone</td></tr><tr><td><code>OtherEmail</code> string</td><td>Customer other email</td></tr><tr><td><code>Region</code> string</td><td>The customer's state, region or territory, this is a 2 or 3-letter code. See <a href="/pages/NJwIOKzISGRtxG1QXMBC">supported regions</a>.</td></tr><tr><td><code>OtherDriveAge1</code> integer</td><td>Age of second driver</td></tr><tr><td><code>OtherDriveAge2</code> integer</td><td>Age of third driver</td></tr><tr><td><code>CoverAmount</code> float</td><td>The amount of cover required</td></tr><tr><td><code>PolicyPrice</code> float</td><td>Price of partner policy (if partner sets price). If &#x3C; RC policy then partner price will be used.</td></tr><tr><td><code>VehicleStdLiabilityHigh</code> float</td><td>If >1 standard liability available for vehicle, this is the higher amount. If only 1 standard liability this is that amount.</td></tr><tr><td><code>VehicleStdLiabilityLow</code> float</td><td>If >1 standard liability available for the vehicle this is the lower amount. If only 1 standard liability available, use <code>VehicleStdLiabilityHigh</code>. Policy quotes will use this amount to determine the amount of cover required. If this value isn’t passed in the request then <code>CoverAmount</code> will be used.</td></tr><tr><td><code>VehicleStdLiabilityCurrency</code> string [varchar(3)]</td><td>Currency of vehicle’s standard liability</td></tr><tr><td><code>VehicleSupplierId</code> string</td><td>Vehicle supplier ID</td></tr><tr><td><code>VehicleSupplierIdTwo</code> string</td><td>Vehicle supplier ID of second supplier</td></tr><tr><td><code>VehicleSupplierName</code> string</td><td>Vehicle supplier name</td></tr><tr><td><code>VehicleSupplierCountryId</code> string [varchar(2)]</td><td>Vehicle supplier country code</td></tr><tr><td><code>VehicleName</code> string</td><td>Vehicle name</td></tr><tr><td><code>VehicleCategory</code> string</td><td>Vehicle category (if SIPP not used. e.g. ACRISS code)</td></tr><tr><td><code>VehicleCode</code> string</td><td>Vehicle <a href="https://www.car-hire-centre.co.uk/sipp-code-list.html">SIPP code</a></td></tr><tr><td><code>VehicleBerths</code> string</td><td>Vehicle berths</td></tr><tr><td><code>VehicleOffroad4x4</code> boolean default is <code>false</code></td><td>Whether the vehicle is an off-road 4 Wheeled Drive</td></tr><tr><td><code>VehicleClass</code> string</td><td>Vehicle class</td></tr><tr><td><code>VehicleRentalGross</code> float</td><td>The retail price of the vehicle</td></tr><tr><td><code>VehicleNettPrice</code> float</td><td>The wholesale price of the vehicle paid by the OTA</td></tr><tr><td><code>ContactCustomer</code> boolean [0|1]</td><td>Whether to allow RC email contact with customer</td></tr><tr><td><code>LanguageCode</code> string [varchar(2)] default is <code>en</code></td><td>Two character language code.</td></tr><tr><td><code>VehiclePickupTime</code> datetime in UTC</td><td>The vehicle pickup time in UTC with offset (Atom format)</td></tr><tr><td><code>VehiclePickupCity</code> string [varchar(50)]</td><td></td></tr><tr><td><code>VehiclePickupCountry</code> string [varchar(2)]</td><td></td></tr><tr><td><code>VehicleDropoffTime</code> datetime in UTC</td><td>The vehicle drop off time in UTC with offset (Atom format)</td></tr><tr><td><code>VehicleDropoffCity</code> string [varchar(50)]</td><td></td></tr><tr><td><code>VehicleDropoffCountry</code> string [varchar(2)]</td><td></td></tr><tr><td><code>VehicleTypes</code> string [100]</td><td>Comma separated list of vehicle types. Codes here: <code>car,motorhome,campervan,</code><br><code>4x4,minibus,lighttruck,bus</code><br>Example: <code>car,motorhome,bus</code></td></tr><tr><td></td><td><p>Additional user-defined data, provided as a valid JSON object or JSON string. This field allows clients to send supplementary information relevant to their specific use case. The structure and content of this object are entirely determined by the client.<br><br>e.g.</p><pre><code><strong>{
</strong></code></pre></td></tr><tr><td>"securitytoken": "39456fdhUIHIUH",</td><td></td></tr></tbody></table>

```
"esim": {
    "esim_eligible": true
}
```

**}**

OR

```
"{"securitytoken": "HerbertSu", "esim": {"esim_eligible": true, "esimid": "38947239842"}}"
```

|


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://partner-docs.covergenius.com/rentalcover/endpoints/update.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
