Auto Insurance

Welcome to Engine's Auto Insurance Short Form API Integration Guide!

This document provides everything you need to integrate with Engine's platform and match users with auto insurance offers from carriers and marketplace partners.

Short form is a streamlined auto insurance marketplace flow that requires only 6 core data points to generate personalized offers.

Key Capabilities

⚡ Dynamic offers: Retrieve offers from minimal user, vehicle, and policy-holder information.

⏱️ Asynchronous aggregation: Aggregate carrier and partner offers through a poll-based rate table.

🎯 Personalized results: Show ranked offers, marketing copy, carrier branding, and impression tracking.

🛡️ Compliance: Enable a seamless, compliant, and user-friendly experience.

Getting Started

To retrieve auto insurance offers, submit an offer search with "productTypes": ["AutomobileInsurance"] with:

Field	API property
ZIP code	personalInformation.zipcode
Date of birth	personalInformation.dateOfBirth
Current insurer status	autoInsuranceInformation.currentIssuer or hasAutoInsurance
Number of vehicles	autoInsuranceInformation.numberOfVehicles
Homeowner status	autoInsuranceInformation.policyHolderInformation.isHomeOwner
Military status	autoInsuranceInformation.policyHolderInformation.isMilitary

Unlike some other Engine product lines, the Auto Insurance API is asynchronous: carriers and partners respond to the offer search at different speeds, so your initial request will typically return with the search still in progress. You then poll a second endpoint to retrieve the completed rate table as responses arrive.

Process Overview

Engine recommends polling the rate table endpoint approximately once every second, for up to 15 seconds, or until pendingResponses is empty. Display offers already present in the offers array while polling continues for pending responses.

📘 API Reference Understand the request and response structure.

🎨 Building Your UI Implement display logic and user experience patterns.

🛡️ Compliance Review required disclosures and consents before launch.