Skip to main content

Quotes Refinement Home

Home​

/quoting/v3/quotes/refinement/home/request​

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

See:

Request: HomeQuotesRequest

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",
      "propertyPurchasedInLastSixMonths": true,
      "previousAddress": {
          "streetNumber": "1200",
          "addressLine1": "Appleton Avenue",
          "addressLine2": "",
          "apartmentNumber": "",
          "city": "Orlando",
          "county": "Orange County",
          "state": "FL",
          "zip": "32806"
      },
      "propertyDetails": {
          "propertyType": "SingleFamily",
          "residenceUsage": "PrimaryResidence",
          "yearBuilt": "2018",
          "squareFootage": "3050",
          "roofMaterial": "StandardShingle",
          "bedrooms": "2",
          "bathrooms": "2",
          "marketValue": "125000",
          "fireAlarm": "Local",
          "burglarAlarm": "CentrallyMonitored",
          "gatedCommunity": false
      },
      "carrier": "Progressive",
      "coverageYears": "5",
      "rating": "Good"
  },
  "metadata": {
      "TestKey1": "TestValue1",
      "TestKey2": "TestValue2"
  }
}

This request should produce a response such as:

JSON Response
{
  "traceId": "feb715d7-fae0-4534-8e87-631a97fff58c",
  "errors": [],
  "payload": {
      "quotesCorrelationId": "feb715d7-fae0-4534-8e87-631a97fff58c",
      "onlineJourneyUrl": "https://homeowners-insurance-sandbox.simplyioa.com/?consumerRef=feb715d7-fae0-4534-8e87-631a97fff58c"
  },
  "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.