USA Driving License Verification

Module ID

Name of the Module
usa_dl_verification

Module Description

Verify the Driver's License associated with an individual.

Module Inputs

All of the following inputs are mandatory.

• First Name
• Last Name
• DL Number
• State Code
• Date of Birth

Module Outputs

The following section provides the sample and the corresponding details of the various responses you can expect from the module.

Success Response Sample

You will receive a success response in a format similar to the following code sample if the request is correct.

Success Response

  {
"module": "DL Verification API",
"moduleId": "usa_dl_verification",
"apiResponse": {
  "status": "success",
  "statusCode": "200",
  "result": {
      "details": {
          "dlNumberMatch": true,
          "firstNameMatch": true,
          "lastNameMatch": true,
          "dobMatch": true,
          "stateMatch": true
      },
      "summary": {
          "action": "pass",
          "details": []
      }
  }
  }
}

Error Response Samples

You will receive an error response in a format similar to the following code sample if the request is incorrect.

Error Response Sample - Missing DL Number

  {
"module": "DL Verification API",
"moduleId": "usa_dl_verification",
"apiResponse": {
  "status": "failure",
  "statusCode": "400",
  "error": "dlNumber is required"
}
}

Error Response Sample - No Matching DL Number

  {
"module": "DL Verification API",
"moduleId": "usa_dl_verification",
"apiResponse": {
  "status": "success",
  "statusCode": "200",
  "result": {
      "details": {
          "dlNumberMatch": false,
          "firstNameMatch": null,
          "lastNameMatch": null,
          "dobMatch": null,
          "stateMatch": null
      },
      "summary": {
          "action": "manualReview",
          "details": [
              {
                  "code": "011",
                  "message": "DL number not found"
              }
          ]
      }
  }
}
}

Error Response Sample - No Matching Name

{
"module": "DL Verification API",
"moduleId": "usa_dl_verification",
"apiResponse": {
  "status": "success",
  "statusCode": "200",
  "result": {
      "details": {
          "dlNumberMatch": true,
          "firstNameMatch": false,
          "lastNameMatch": false,
          "dobMatch": false,
          "stateMatch": null
      },
      "summary": {
          "action": "fail",
          "details": [
              {
                  "code": "012",
                  "message": "First name is not matching"
              },
              {
                  "code": "013",
                  "message": "Last name is not matching"
              }
          ]
      }
  }
}
}

Error Response Sample - Internal Server Error

{
"module": "DL Verification API",
"moduleId": "usa_dl_verification",
"apiResponse": {
  "status": "failure",
  "statusCode": "500",
  "error": "Internal server error"
}
}

Possible Error Codes in the Summary Action:

• 011: DL number not found
• 012:First name is not matching
• 013: Last name is not matching
• 014: DoB is not matching
• 015: State is not matching

Explanation for the different responses:

• Case 1: DL Number is successfully matched (true) -

Other fields would return true in case of a match and false in case of no match and null if no information could be found in the database regarding that field.

• Case 2: DL Number is not matched (false) -

Other fields would return null as there is nothing to match based on no record.

State Code	State Name
WA	Washington
OR	Oregon
ID	Idaho
MT	Montana
WY	Wyoming
CO	Colorado
AZ	Arizona
NM	New Mexico
ND	North Dakota
SD	South Dakota
NE	Nebraska
KS	Kansas
TX	Texas
IA	Iowa
MO	Missouri
AR	Arkansas
WI	Wisconsin
IL	Illinois
MI	Michigan
IN	Indiana
OH	Ohio
KY	Kentucky
TN	Tennessee
MS	Mississippi
WA	Washington
NC	North Carolina
GA	Georgia
FL	Florida
ME	Maine
VT	Vermont
MA	Massachusetts
CT	Connecticut
RI	Rhode Island
NJ	New Jersey
DE	Delaware
MD	Maryland
DC	District of Columbia