Drivers License

Verify Drivers license number using FRSC database.

There are 2 types of Driver License APIs

1. Driver License Number Lookup

Validate the driver license number of a user against the government database. This API requires just Driver License number as input.

Request:

{
    "template_id" : "NG_DRIVER_LICENSE_NUMBER_VERIFICATION",
    "user_data": {
        "identity": {
            "identity_country_code": "NG",
            "identity_number_type": "DRIVER_LICENSE",
            "identity_number": "{{Valid_Driver_license_Number}}",
        }
    }
}

Response:

{
    "aiprise_summary": {
        "verification_result": "APPROVED"
    },
    "client_reference_id": null,
    "created_at": 123456789,
    "id_info": {
        // Id Info result
        "result": "APPROVED",

        // Normalized Fields
        "birth_date": "YYYY-MM-DD",
        "first_name": "",
        "middle_name": "",
        "gender": "",
        "id_expiry_date": "YYYY-MM-DD",
        "id_issue_date": "YYYY-MM-DD",
    		"issue_country": "Nigeria",
    		"issue_country_code": "NG",
        "id_number": "",
        "id_type": "DRIVER_LICENSE_NUMBER",
        "last_name": "",
      
        // Government lookup details
        "lookup_details": {
            "lookup_list": [
                {
                    "lookup_source": "Federal Road Safety Commission (FRSC)",
                    "lookup_type": "DRIVER_LICENSE",
                    "issuer_country_code": "NG",
                    "lookup_data": {
                        "birth_date": "",
                        "expiry_date": "",
                        "first_name": "",
                        "gender": "",
                        "issue_date": "",
                        "issue_state": "",
                        "last_name": "",
                        "license_number": "",
                        "middle_name": "",
                        "user_photo": "<Base64String>"
                    },

                }
            ]
        }
    },
    "status": "COMPLETED",
    "template_id": "{{YOUR_TEMPLATE_ID}}",
    "verification_session_id": ""
}

2. Driver License Number Lookup + Face Match

Validate the driver license number of a user against the government database along with the face match. This API requires Driver License number and user's selfie as input.

{
    "template_id" : "NG_DRIVER_LICENSE_NUMBER_VERIFICATION",
    "user_data": {
        "identity": {
            "identity_country_code": "NG",
            "identity_number_type": "DRIVER_LICENSE",
            "identity_number": "{{Valid_Driver_license_Number}}",
        },
        "selfie": "{{Valid_Base64_String}}"
    }
}

Response:

{
    "aiprise_summary": {
        "verification_result": "APPROVED"
    },
    "client_reference_id": null,
    "created_at": 123456789,
  
     // Face Match Info
    "face_match_info": {
      "face_match_score": 98.44,
      "result": "APPROVED"
    },
 
    "id_info": {
        // Id Info result
        "result": "APPROVED",

        // Normalized Fields
        "birth_date": "YYYY-MM-DD",
        "first_name": "",
        "middle_name": "",
        "gender": "",
        "id_expiry_date": "YYYY-MM-DD",
        "id_issue_date": "YYYY-MM-DD",
    		"issue_country": "Nigeria",
    		"issue_country_code": "NG",
        "id_number": "",
        "id_type": "DRIVER_LICENSE_NUMBER",
        "last_name": "",
      
        // Government lookup details
        "lookup_details": {
            "lookup_list": [
                {
                    "lookup_source": "Federal Road Safety Commission (FRSC)",
                    "lookup_type": "DRIVER_LICENSE",
                    "issuer_country_code": "NG",
                    "lookup_data": {
                        "birth_date": "",
                        "expiry_date": "",
                        "first_name": "",
                        "gender": "",
                        "issue_date": "",
                        "issue_state": "",
                        "last_name": "",
                        "license_number": "",
                        "middle_name": "",
                        "user_photo": "<Base64String>"
                    },

                }
            ]
        }
    },
    "status": "COMPLETED",
    "template_id": "{{YOUR_TEMPLATE_ID}}",
    "verification_session_id": ""
}