Why is "X" sometimes not allowed as a driver's gender value?
Issue
A rate call fails with an error stating: 'X' is not an allowed value for Gender
Example
Example of the quote request:
"drivers": [
{
"activeDutyMilitary": false,
"ageWhenLicensed": 18,
"dob": "1922-01-17",
"firstName": "Betty",
"gender": "X",
"goodStudent": false,
"lastName": "White",
"id": "<id#>",
"licenseNumber": "TYFBAF123",
"licenseState": "IL",
"maritalStatus": "Single",
"nameSuffix": "",
"yearsLicensedSelection": "More than 3 years"
}Example of the error returned:
},
"gender": {
"value": "X",
"inferredValue": null,
"valid": false,
"message": "'X' is not an allowed value for Gender",
"requirements": [
{
"fulfilled": false,
"kind": "inclusion",
"message": "'X' is not an allowed value for Gender",
"metadata": {
"options": [
"M",
"F"
]
}
}
]
},Cause
This error is returned because 'X' is only a valid value option for the profile.drivers[].gender in the Oregon market.
The following values are acceptable for profile.drivers[].gender:
- M (for male)
- F (for female)
- X (for unspecified)
Reference: Create quote Under Body Params > Profile > PROFILE OBJECT > drivers > gender it notes:
The driver's gender. Note: "X" is only valid in certain markets.
Allowed: M F X
Resolution
Since gender is not required, there are three options to resolve this:
1.) Recommended: Allow 'X' and pass it to us for Oregon customers only (profile.state is OR); do not pass gender at all in any other market when the customer does not specify male/female.
2.) Do not pass gender in any market when the customer does not specify male/female.
- Therefore, only ever pass us M or F in all markets. You may pass 'nil' otherwise, or simply do not provide the gender field.
3.) Never pass gender.
- **NOTE:**This is not a recommended approach since gender will help Root provide more accurate quotes.
Updated 20 days ago