[Beta] Attested Credit
We have enhanced quoting endpoints to accept and return credit information as optional data that may improve early rating accuracy.
The four tiers options that we have defined currently are:
- Poor
- Average
- Good
- Excellent
You will need to work with your Account Manager to map out the credit score ranges for each of the tiers.
Default behavior: If the user responds "Unsure" or no response, we will default them to "Average". If this is the case please leave the scoreTier field empty, it is not required.
Disclaimer: as of writing (true up to 3/12/25), this functionality is not affecting production RC1's. Nevertheless, we highly encourage partners to start experimenting and implementing the changes if desired. This way you will immediately begin receiving improved RC1s as soon as Root launches the inclusion of attested credit (assuming you have already worked with your Account Manager on providing your credit score ranges).
Affected Endpoints
What Changed
We added credit
as an optional attribute on a driver.
Example of providing driver credit scoreTier
scoreTier
{
"profile": {
"drivers": [
{
"credit": {
"scoreTier": "good"
}
}
]
}
}
In the event the providedscoreTier
is not allowed, the response will include "valid": false
and a displayable "message"
attribute for the user alongside a "requirements"
attribute denoting the available options. Example below:
{
"quote": {
"profile": {
"drivers": [
{
"credit": {
"scoreTier": {
"value": "okay",
"valid": false,
"message": "Value is not an allowed value",
"requirements": [
{
"fulfilled": false,
"kind": "inclusion",
"message": "Value is not an allowed value",
"metadata": {
"options": [
"excellent",
"good",
"average",
"poor"
]
}
}
]
}
}
}
]
}
}
}