InstantBooking

What it does: Creates a quote and confirms the booking in a single API call.

When to call it: When you want to purchase a policy without a separate Quote step. For example, in a streamlined checkout where the protection price is already known.

PolicyCode required

Because there is no separate Quote step, you must supply a PolicyCode. Your CSE will provide the codes available for your account.

POST /insurances/instantBooking

Example request

POST

curl -i -X POST \
  -H "X_API_KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "FromDate": "2025-08-01 00:00:00",
    "ToDate": "2025-08-08 00:00:00",
    "CustomerAge": 29,
    "Email": "[email protected]",
    "FirstName": "Jane",
    "LastName": "Smith",
    "Country": "NZ",
    "DestinationCountry": "NZ",
    "PolicyCode": "FP-NZ-ROW",
    "LanguageCode": "en",
    "Currency": "AUD",
    "PartnerCollectingPayment": true,
    "City": "Auckland",
    "Address1": "1 Queen Street",
    "PostalCode": "1010"
  }' \
  https://api-staging.rentalcover.com/insurances/instantBooking

Response

{
    "BookingId": "5805150",
    "Reference": "N7U4-A2JE-INS",
    "Status": "Confirmed",
    "FromDate": "2024-04-19 00:00:00",
    "ToDate": "2024-04-22 00:00:00",
    "TotalAmount": "21.64",
    "ConfirmedOn": "2024-04-17 23:17:41",
    "PartnerSiteCode": null,
    "InsuranceCoverAmount": "92100.00",
    "TotalAmountFormatted": "AU$21.64",
    "InsuranceCoverAmountFormatted": "AU$92,100.00",
    "Disclaimer": "By clicking the button you confirm that you have considered the terms of the <a href=\"https://staging.rentalcover.com/pds/N7U4-A2JE-INS\" target=\"_blank\">PDS</a>. Asservo Mutual (NZBN 9429051103644) is the issuer of the mutual risk products and RentalCover.com, a trading name of Cover Genius Pty Ltd (ABN 43 159 983 598, AFSL No.490058) is its' agent. As a member of Asservo Mutual, you can view the Constitution on its' <a href=\"https://asservoprotection.com/\" target=\"_blank\">website</a>.\n",
    "VehicleTypes": {
        "freecancellationcover": false,
        "freetravelinsurance": false,
        "car": true,
        "motorhome": false,
        "campervan": false,
        "4x4": false,
        "minibus": false,
        "lighttruck": false,
        "bus": false,
        "caravan": false
    },
    "Logos": {
        "DarkFontPng": {
            "Type": "png",
            "Url": "https://files.rentalcover.com/logos/RentalCover.png"
        },
        "DarkFontSvg": {
            "Type": "svg",
            "Url": "https://files.rentalcover.com/logos/RentalCover.svg"
        },
        "LightFontPng": {
            "Type": "png",
            "Url": "https://files.rentalcover.com/logos/RentalCover-inverse.png"
        },
        "LightFontSvg": {
            "Type": "svg",
            "Url": "https://files.rentalcover.com/logos/RentalCover-inverse.svg"
        }
    },
    "Policy": {
        "Code": "FP NZ ROW inc.Baggage - Asservo Mutual",
        "Name": "Full Protection",
        "Type": "FullProtection",
        "PdsUrl": "https://staging.rentalcover.com/pds/N7U4-A2JE-INS"
    },
    "Customer": {
        "CustomerId": "347568",
        "FirstName": "Test",
        "LastName": "Test",
        "Email": "[email protected]",
        "BackupEmail": "",
        "DateOfBirth": "1995-01-01",
        "Age": "29",
        "Phone": "0432-488-899",
        "Address1": "abc street",
        "Address2": "",
        "City": "brisbane",
        "Region": "SAN FRAN",
        "PostalCode": "55555",
        "Country": "New Zealand"
    }
}

Request parameters

InstantBooking accepts Group A (Core booking), Group B (Customer), and Group F (Partner & integration), plus the differences listed below.

Differences from Quote

Parameter	Required?	Note
PolicyCode	Required	Policy code to purchase. No Quote step means this must be supplied explicitly. Provided by your CSE.
LanguageCode	Required	Required here; optional in Quote.
Currency	Required	Required here; optional in Quote.
AgentReference	Optional	Partner-supplied booking reference ending in -INS. Auto-generated if omitted.
PartnerReference	Optional	Your internal booking reference for customer service lookup.

Not accepted by InstantBooking

All Group C (Vehicle) fields, FromLocationName, ToLocationName, VehiclePickupTime, VehicleDropoffTime and all other pickup/drop-off location fields, LDWIncluded, SLIIncluded, OtherEmail, OtherDriveAge1/2, ExpressCode, RoadSideAssistanceCoverOption, BWCookie, UserIpAddress, ContactCustomer, CoverAmount, Type.

Response

Booking

Field	Type	Description
Reference	string	Unique booking reference ending in -INS. Use this for Update and Cancel.
BookingId	integer	Internal booking ID.
Status	string	InstantBooking returns Confirmed directly.
ConfirmedOn	datetime	Timestamp of when the booking was confirmed.
PartnerReference	string	Partner reference from the request, if supplied.

Pricing

Field	Type	Description
TotalAmount	float	Total premium charged.
TotalAmountFormatted	string	Formatted total premium.
InsuranceCoverAmount	float	Total cover amount.
InsuranceCoverAmountFormatted	string	Formatted cover amount.
Disclaimer	string	Product disclaimer text.

Vehicle coverage

Field	Type	Description
VehicleTypes.*	boolean	Flags indicating which vehicle types this product covers. Keys: car, motorhome, campervan, 4x4, minibus, lighttruck, bus, caravan, freecancellationcover, freetravelinsurance.

Logos

Field	Type	Description
Logos.DarkFontPng.Url	string	URL to the dark-font PNG logo.
Logos.DarkFontSvg.Url	string	URL to the dark-font SVG logo.
Logos.LightFontPng.Url	string	URL to the light-font PNG logo.
Logos.LightFontSvg.Url	string	URL to the light-font SVG logo.

Nested objects

Field	Object type	Reference
Policy	Policy object (subset)	Returns Code, Name, Type, and PdsUrl only. See Policy object.
Customer	Customer object	See Customer object.