Skip to main content

Quotes Refinement Auto

Auto​

/quoting/v3/quotes/refinement/auto/request​

Initiates a auto insurance quotes refinement session and triggers the asynchronous quoting process, while also generating a SimplyIOA consumer journey URL for the auto journey.

See:

Request: AutoQuotesRequest

Response: RequestQuotesRefinement

Example POST Request​

Consider the following JSON request made via the developer portal:

JSON Post Request
{
  "firstName": "Jake",
  "lastName": "Ward",
  "dateOfBirth": "1990-05-29",
  "email": "test@test.com",
  "phone": "541 754 3010",
  "campaignCode": "MAGIC",
  "productData": {
      "address": {
      "streetNumber": "1434",
      "addressLine1": "Appleton Avenue",
      "addressLine2": "",
      "apartmentNumber": "6b",
      "city": "Orlando",
      "county": "Orange County",
      "state": "FL",
      "zip": "32806"
      },
      "gender": "Male",
      "drivers": [
      {
          "firstName": "Jake",
          "lastName": "Ward",
          "licenseStatus": "PersonalAuto",
          "licenseObtainedAge": "17",
          "licenseEverSuspendedOrRevoked": false,
          "sr22Required": false,
          "gender": "Male",
          "dateOfBirth": "1980-10-01",
          "maritalStatus": "Single",
          "occupation": "Architect",
          "educationLevel": "SomeHighSchool",
          "relationshipToApplicant": "Insured",
          "violations": [
          {
              "violationDate": "2020-01-01",
              "type": "CellPhone"
          }
          ],
          "claims": [
          {
              "claimDate": "2022-06-01",
              "amount": "450",
              "type": "Wing mirror"
          }
          ]
      }
      ],
      "vehicles": [
      {
          "vin": "19XFC1F84HE004530",
          "year": "2023",
          "make": "Honda",
          "model": "Civic",
          "subModel": "Type R",
          "primaryUse": "Personal",
          "garageType": "AttachedGarage",
          "parkedAtMailingAddress": true,
          "garagingAddress": {
          "streetNumber": "1434",
          "addressLine1": "Appleton Avenue",
          "addressLine2": "",
          "apartmentNumber": "6b",
          "city": "Orlando",
          "county": "Orange County",
          "state": "FL",
          "zip": "32806"
          },
          "oneWayDistance": "17",
          "annualMileage": "10000",
          "ownership": "Leased",
          "coveragePackage": "Basic"
      }
      ],
      "maritalStatus": "Married",
      "yearsAtCurrentAddress": "10",
      "homeOwnership": "OwnedHouse",
      "creditRating": "Excellent",
      "bankruptcy": false,
      "currentCarrier": "Progressive",
      "currentInsuranceExpirationDate": "2023-05-09",
      "currentInsuranceYears": "TenOrMoreYears",
      "bodilyInjuryLiabilityLimit": "BI_100000_300000"
  },
  "metadata": {
      "TestKey1": "TestValue1",
      "TestKey2": "TestValue2"
  }
}

This request should produce a response such as:

JSON Response
{
  "traceId": "23a11976-5279-4cc2-abb7-646ce16433e3",
  "errors": [],
  "payload": {
      "quotesCorrelationId": "23a11976-5279-4cc2-abb7-646ce16433e3",
      "onlineJourneyUrl": "https://car-insurance-sandbox.simplyioa.com/?consumerRef=23a11976-5279-4cc2-abb7-646ce16433e3"
  },
  "metadata": {
      "TestKey1": "TestValue1",
      "TestKey2": "TestValue2"
  }
}

The property quotesCorrelationId within the payload, contains the identifier used to retrieve any quotes that may have been generated from this endpoint. These are retrieved through the Retrieve Quotes endpoint below. The property onlineJourneyUrl can be used to go through the SimplyIOA consumer journey where quotes can be refine further.