Nigeria Email Verification

Module ID

Name of the Module
nga_nin_check_api

Module Description

Fetch details of a customer from NIN database.

Module Inputs

NIN Number

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

  {
"moduleId": "nga_nin_check_api",
"moduleName":"Nigeria NIN Check",
"apiResponse": {
"status": "success",
"statusCode": "200",
"result": {
    "detail": "Verification Successfull",
    "nin_data": {
        "nin": "22034354227",
        "firstName": "OLUWAFUNMIBI",
        "middleName": "LAWRENCE",
        "lastName": "OSAYEMI",
        "phoneNumber": "08149565065",
        "dateOfBirth": "07-11-1992",
        "townOfResidence": "",
        "lgaOfResidence": "",
        "stateOfResidence": "",
        "residentialAddress": "",
        "lgaOfOrigin": "",
        "stateOfOrigin": "",
        "maritalStatus": ""
    }
}
}
}

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 - NIN Not Found

  {
"moduleId": "nga_nin_check_api",
"moduleName": "Nigeria NIN Check",
"apiResponse": {
"status": "success",
"statusCode": "200",
"result": {
    "message": "Record not found"
}
}
}

Error Response Sample - Wrong Format

  {
"moduleId": "nga_nin_check_api",
"moduleName": "Nigeria NIN Check",
"apiResponse": {
"status": "failure",
"statusCode": "400",
"error": {
    "detail": {
        "number": [
            "This value does not match the required pattern."
        ]
    }
}
}
}