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.