Quick Start

Before you begin

You need the following before making your first API call:

• API credentials: contact your Cover Genius Client Solutions Engineer (CSE) to receive your staging API key.
• HTTPS: all API requests must use HTTPS. HTTP calls are rejected in production.

A server-side environment: the RentalCover API is a server-to-server integration. Never expose your API key in client-side code.

End-to-end test walkthrough

Walk through the steps below to validate your integration before going live. Confirm you receive the expected response at each step before continuing.

Step 1. Get a quote

curl -i -X POST \
  -H "X_API_KEY: your_staging_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "FromDate": "2025-08-01 00:00:00",
    "ToDate": "2025-08-08 00:00:00",
    "CustomerAge": 32,
    "DestinationCountry": "IE",
    "Country": "US",
    "FirstName": "Jane",
    "LastName": "Smith",
    "Email": "[email protected]"
  }' \
  https://api-staging.rentalcover.com/insurances/quote

✅ Expect a 200 response containing a Reference (e.g. AB12-345C-INS) and a TotalAmount. Save the Reference - you'll use it as AgentReference in all subsequent steps.

Step 2. Retrieve content

curl -i -X POST \
  -H "X_API_KEY: your_staging_api_key" \
  -H "Content-Type: application/json" \
  -d '{"AgentReference": "AB12-345C-INS", "LanguageCode": "en"}' \
  https://api-staging.rentalcover.com/insurances/content

✅ Expect marketing copy, logos, and comparison table data.

Step 3. Record opt-in

curl -i -X POST \
  -H "X_API_KEY: your_staging_api_key" \
  -H "Content-Type: application/json" \
  -d '{"CoverOptIn": 1, "PartnerReference": "PARTNER-REF-001"}' \
  https://api-staging.rentalcover.com/insurances/coverOptOut/AB12-345C-INS

✅ Expect {"success": "..."}.

Step 4. Purchase protection

curl -i -X POST \
  -H "X_API_KEY: your_staging_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "AgentReference": "AB12-345C-INS",
    "PolicyCode": "<Policy.Code from Quote response>",
    "FromDate": "2025-08-01 00:00:00",
    "ToDate": "2025-08-08 00:00:00",
    "CustomerAge": 32,
    "DestinationCountry": "IE",
    "Country": "US",
    "FirstName": "Jane",
    "LastName": "Smith",
    "Email": "[email protected]",
    "Address1": "123 Main St",
    "City": "New York",
    "PostalCode": "10001",
    "CardHolder": "JANE SMITH",
    "CardNumber": "4242424242424242",
    "CardExpiry": "0828",
    "CardSecurityCode": "123"
  }' \
  https://api-staging.rentalcover.com/insurances/purchase

✅ Expect Status: PendingConfirm.

Step 5. Verify confirmation

curl -i -X GET \
  -H "X_API_KEY: your_staging_api_key" \
  https://api-staging.rentalcover.com/insurances/status/AB12-345C-INS

✅ Expect Status: Confirmed.

Step 6. Cancel protection

curl -i -X POST \
  -H "X_API_KEY: your_staging_api_key" \
  -H "Content-Type: application/json" \
  -d '{"CancelReason": "Test cancellation"}' \
  https://api-staging.rentalcover.com/insurances/cancel/AB12-345C-INS

✅ Expect Status: Confirmed.

Test payment cards

Use these card details in the Purchase step above. Do not use real card numbers.

Card number	Cardholder	Expiry	CVV	Result
4242 4242 4242 4242	Any name	Any future date	Any	Successful payment
4012 8888 8888 1881	Any name	Any future date	Any	Successful payment (alternate)

For additional test scenarios including declined cards and 3D Secure flows, see the Stripe test cards reference.