> For the complete documentation index, see [llms.txt](https://partner-docs.covergenius.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://partner-docs.covergenius.com/rentalcover/shared-reference/booking-statuses-and-errors.md).

# Booking Statuses & Errors

## Booking Statuses

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Status</th><th>Meaning</th></tr></thead><tbody><tr><td><code>Received</code></td><td>Quote created; payment has not yet been taken.</td></tr><tr><td><code>PendingConfirm</code></td><td>Payment has been taken; final confirmation from the insurer is pending.</td></tr><tr><td><code>Confirmed</code></td><td>Protection is active and confirmed by the insurer.</td></tr><tr><td><code>Cancelled</code></td><td>Protection has been cancelled.</td></tr></tbody></table>

## Errors

The RentalCover API uses standard HTTP status codes. When a request fails, the response body contains a JSON object describing the error.

### **HTTP status codes**

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="120.1185302734375">Code</th><th width="194.63623046875">Meaning</th><th>What to do</th></tr></thead><tbody><tr><td><code>200</code></td><td>Success</td><td>The request completed successfully.</td></tr><tr><td><code>400</code></td><td>Bad request</td><td>A required parameter is missing, invalid, or the request conflicts with the current booking state. Read the error message in the response body.</td></tr><tr><td><code>401</code></td><td>Unauthorised</td><td>Your API key is missing or invalid. Check the <code>X_API_KEY</code> header.</td></tr><tr><td><code>404</code></td><td>Not found</td><td>The endpoint or resource does not exist. Check the URL and booking reference.</td></tr><tr><td><code>500</code></td><td>Internal server error</td><td>An unexpected error occurred on the RentalCover server. Contact your CSE if this persists.</td></tr></tbody></table>

### Error response body

```json
// Single-field validation error
{
  "errors": {
    "email": ["Email cannot be blank."]
  }
}

// General request error
{
  "errors": ["Policy cannot be purchased or modified after the date of travel"]
}
```

### Common error scenarios

General errors typically return `HTTP 400`.

#### Quote errors

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="335.20849609375">Scenario</th><th>Example error</th></tr></thead><tbody><tr><td>Required field missing</td><td>"Email cannot be blank." / "FromDate: must be in the future"</td></tr><tr><td>Invalid country code</td><td>"Country is too long (maximum is 2 characters)."</td></tr><tr><td>Invalid language code</td><td>"Language Code is too long (maximum is 5 characters)."</td></tr><tr><td>SIPP code not covered by underwriters</td><td>"No policies available for SIPP code."</td></tr><tr><td>Region without trading licence</td><td>"No policies are available for the requested state, province or territory."</td></tr></tbody></table>

#### Purchase errors

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="335.4342041015625">Scenario</th><th>Example error</th></tr></thead><tbody><tr><td>Booking details differ from quote</td><td>"Policy not found"</td></tr><tr><td>Purchase attempted after travel date</td><td>"Policy cannot be purchased or modified after the date of travel"</td></tr><tr><td>Booking not found</td><td>"Booking details not found"</td></tr><tr><td>Payment failure</td><td>"Payment validation failed, please make sure your credit card details are correct or try another card"</td></tr><tr><td>Invalid or expired coupon</td><td>"Invalid or expired coupon, please try again or remove coupon"</td></tr></tbody></table>

#### Cancel errors

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="335.0452880859375">Scenario</th><th>Example error</th></tr></thead><tbody><tr><td>Invalid booking reference</td><td>"Booking not found"</td></tr><tr><td>Already cancelled</td><td>"Booking AB12-345C-INS can not be cancelled, already been cancelled on 2024-01-23"</td></tr><tr><td>Claim in progress</td><td>"Booking 98PD-SEQN-INS can not be cancelled, claim in progress"</td></tr><tr><td>Charge dispute raised</td><td>"Booking F8TU-62C6-INS can not be cancelled as it has been disputed"</td></tr></tbody></table>

For further troubleshooting, please contact your CSE.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://partner-docs.covergenius.com/rentalcover/shared-reference/booking-statuses-and-errors.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
