NIN (with Phone Number)

Verify a customer’s identity using the mobile phone number registered to their National Identity Number (NIN) through the National Identity Management Commission (NIMC). This method allows you to authenticate an individual by matching their NIN record to the linked phone number provided.

To verify NIN with Phone Number

{{baseUrl}}/v1/ng/identities/nin-phone/{idNumber}

Path Parameter

Parameters	Type	Description
idNumber : Phone Number (REQUIRED)	string	Phone number

Request Body

POST Parameters	Type	Description
firstname (REQUIRED)	string	First Name
lastname (REQUIRED)	string	Last Name
dob (OPTIONAL)	dateString	Date Of Birth (YYYY-MM-DD)
phone (OPTIONAL)	string	Phone Number
email (OPTIONAL)	string	Email Address
gender (OPTIONAL)	string	Gender

This endpoint will return all bio-data information captured, up to 46 data sets. To conduct an actual test

Response Sample

{
    "id": 1**93,
    "applicant": {
        "firstname": "Bunch",
        "lastname": "Dillon"
    },
    "summary": {
        "nin_check": {
            "status": "EXACT_MATCH",
            "fieldMatches": {
                "firstname": true,
                "lastname": true
            }
        }
    },
    "status": {
        "state": "complete",
        "status": "verified"
    },
    "insight": [  // detail of other organisations that have checked this same ID recently
        {
            "serviceCategory": "Commercial Banks",
            "insightCount": 1,
            "timeframeInMonths": 12
        },
        {
            "serviceCategory": "Digital Bank",
            "insightCount": 1,
            "timeframeInMonths": 12
        }
    ],
    "nin": {
        "nin": "63184876213",
        "firstname": "Bunch",
        "lastname": "Dillon",
        "middlename": "John",
        "phone": "08000000000", 
        "gender": "m",
        "birthdate": "06-01-1974",
        "photo":"base 64 encoded",
        "address": "5, Adeniyi Jones, Ikeja, Lagos"
   }
}