15 min read

Creating Quotes

Generate real-time insurance quotes for shipping protection, cyber insurance, and more.

Overview

The Quotes API allows you to generate real-time insurance quotes. Quotes are valid for 24 hours and can be bound to create active policies.

Basic Quote Request

Create a quote by specifying the product type and coverage details:

const quote = await coverkit.quotes.create({
  product: 'shipping_protection',
  coverage: {
    itemValue: 15000,      // $150.00 in cents
    shippingMethod: 'ground',
    origin: {
      country: 'US',
      postalCode: '10001',
    },
    destination: {
      country: 'US',
      postalCode: '90210',
    },
  },
  customer: {
    email: 'customer@example.com',
  },
});

Quote Response

The API returns a quote object with pricing and coverage details:

{
  "id": "quote_abc123",
  "product": "shipping_protection",
  "status": "pending",
  "premium": 299,           // $2.99 in cents
  "coverage": {
    "itemValue": 15000,
    "deductible": 0,
    "coverageLimit": 15000
  },
  "expiresAt": "2024-12-21T00:00:00Z",
  "createdAt": "2024-12-20T00:00:00Z"
}

Product Types

Shipping Protection

shipping_protection

Coverage for lost, damaged, or stolen packages during shipping.

Cyber Insurance

cyber_insurance

Coverage for data breaches, cyber attacks, and business interruption.

Professional Liability

professional_liability

E&O coverage for professional services and consulting.

Rental Protection

rental_protection

Coverage for rental properties and equipment.

Pricing Factors

Quote premiums are calculated based on:

Item Value - The total value being insured
Product Type - Different products have different base rates
Risk Factors - Shipping method, destination, item category
Coverage Options - Deductible, coverage limits

Quote Expiration

Quotes are valid for 24 hours by default. You can check the expiresAt field to see when a quote expires. Expired quotes cannot be bound - you'll need to create a new quote.