Estimated Quote (RC1) Requirements

Property	Request payload location	Notes
Address Line 1	`profile.address1`	This is part of the Profile object.
Address City	`profile.city`	This is part of the Profile object.
Address State	`profile.state`	This is part of the Profile object.
Address Zip	`profile.zip`	This is part of the Profile object.
Policyholder Driver ID	`profile.policyholderDriverId`	This is part of the Driver object. This UUID value is arbitrary, but must match the ID property of a driver also included in the payload.
Driver First Name	`profile.drivers[].firstName`	This is part of the Driver object.
Driver Last Name	`profile.drivers[].lastName`	This is part of the Driver object.
Driver Date of Birth	`profile.drivers[].dob`	This is part of the Driver object. The driver's date of birth in ISO 8601 full-date format. See RFC 3339 section 5.6: https://www.rfc-editor.org/rfc/rfc3339#section-5.6.
Driver ID*	`profile.drivers[].id`	This is part of the Driver object. An ID value must be attached to the PNI driver, so that we can refer to it in the policyholderDriverId.
Vehicle VIN	`profile.vehicles[].vin`	This is part of the Vehicle object. Root can accept "short VIN"s to generate estimated quotes, although full VIN values are required for RC3/bindable quotes. Additional details are available below.

Examples

Request with Short VIN

Note: You will see a validation error for short VINs since our validation informs bindable (RC3) quote requirements. Additional details below.

{  
  "profile": {  
    "address1": "123 Main Street",  
    "city": "El Paso",  
    "state": "TX",  
    "zip": "79928",  
    "policyholderDriverId": "d4068561-8cc2-4289-8206-122ad1a3e95c",  
    "drivers":[
      {           
        "firstName": "TestFirst",
        "lastName": "TestLast",
        "dob": "1987-04-30",
        "id": "d4068561-8cc2-4289-8206-122ad1a3e95c"
      }
    ],
    "vehicles": [
      {
        "vin": "5TBRT341&4"
      }
    ]
  }
}

Request with Full VIN

{  
  "profile": {  
    "address1": "123 Main Street",  
    "city": "El Paso",  
    "state": "TX",  
    "zip": "79928",  
    "policyholderDriverId": "d4068561-8cc2-4289-8206-122ad1a3e95c",  
    "drivers":[
      {           
        "firstName": "TestFirst",
        "lastName": "TestLast",
        "dob": "1987-04-30",
        "id": "d4068561-8cc2-4289-8206-122ad1a3e95c"
      }
    ],
    "vehicles": [
      {
        "vin": "5TBRT34134S453687"
      }
    ]
  }
}

Successful Estimated Quote (RC1) Response

Once we have enough data to produce an estimated quote (RC1), the status and kind for the quote will be updated to reflect that we have started quoting. Please, poll our Get quote endpoint every 0.5-1 seconds until the status changes.

{
  "quote": {
    "id": "41f02796-8ecf-4281-95f3-9ed2625aa0ce",
    "status": "quoting",
    "kind": "estimated_quote",
    // ...
  },
  // ...
}

Short VIN behavior

Root detects short VIN values using the regular expression /^[0-9A-HJ-NPR-Z&*]{8}.[0-9A-HJ-NPR-Z]{1,8}$/ (ECMA 262 standard). An interactive demo is available here, so that integrations may test their own VIN values using the same expression. Longer, stubbed VINs may be trimmed to meet these formatting requirements.

Quoting note: short VIN values are valid for estimated (RC1) quotes, but not bindable ones. You should expect validation errors in quote responses following successful RC1 generation, as those are informing bindable (RC3) quote requirements. Estimated quotes will continue to be generated, assuming those requirements remain met.