# Estimated Quote (RC1) Requirements

| Property               | Request payload location       | Notes                                                                                                                                                                                                                                                     |
| ---------------------- | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Address Line 1         | `profile.address1`             |                                                                                                                                                                                                                                                           |
| Address City           | `profile.city`                 |                                                                                                                                                                                                                                                           |
| Address State          | `profile.state`                |                                                                                                                                                                                                                                                           |
| Address Zip            | `profile.zip`                  |                                                                                                                                                                                                                                                           |
| Policyholder Driver ID | `profile.policyholderDriverId` | 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`  |                                                                                                                                                                                                                                                           |
| Driver Last Name       | `profile.drivers[].lastName`   |                                                                                                                                                                                                                                                           |
| Driver Date of Birth   | `profile.drivers[].dob`        | 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](https://www.rfc-editor.org/rfc/rfc3339#section-5.6).                                                              |
| *Driver ID*\*          | `profile.drivers[].id`         | 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`       | 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](https://root-bind-api.readme.io/docs/estimated-quote-requirements#short-vin-behavior). |

## 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](https://root-bind-api.readme.io/docs/estimated-quote-requirements#short-vin-behavior).*

```json Request: RC1 with Short 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": "5TBRT341&4"
      }
    ]
  }
}



```

### Request with Full VIN

```json Request: RC1 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](https://root-bind-api.readme.io/reference/getquote#/) every 0.5-1 seconds until the **status** changes.

```json Response: RC1 Quoting
{
  "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](https://json-schema.org/understanding-json-schema/reference/regular_expressions)). An interactive demo is available [here](https://rubular.com/r/TnjysLM5tUyreF), 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.*