Attested Credit
We have enhanced quoting endpoints to accept credit information for each driver 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.
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"
]
}
}
]
}
}
}
]
}
}
}