Skip to main content

NIN MINI


The NIN Mini service provides a reliable way to validate a customer's or user's National Identity Number (NIN) data, ensuring accuracy and compliance with identity verification standards.

To verify NIN Mini

Request Body

POST ParametersTypeDescription
nin (REQUIRED)stringNational Identity Number
fistname (REQUIRED)stringFirst Name
lastname (REQUIRED)stringLast Name
dob (OPTIONAL)dateStringDate Of Birth (YYYY-MM-DD)
phone (OPTIONAL)stringPhone Number
email (OPTIONAL)stringEmail Address
gender (OPTIONAL)stringGender
refreshbooleanTo refresh the database for update data
simulate_successbooleanIf project in sandbox, set to true to simulate success

This endpoint returns Boolean values (true/false) for your selected parameters. To conduct an actual test

Response Sample



{
"code": 200,
"message": "Request successful",
"status": true,
"data": {
"verification": {
"product_id": 2,
"status": "success",
"type": "nin_mini",
"project_id": 1,
"data": {
"nin": "18069759722",
"firstname": "john",
"lastname": "doe",
"secret_hash": "astpzsBs5SJ3d7Jo",
"data": {
"nin": "18069759722",
"firstname": "JOHN",
"lastname": "DOE",
"middlename": "MIN",
"phone": "0701111111",
"gender": "m",
"photo": "\/9j\/4AAQSkZJRgABAgAAAQABAAD\/UDG8Nn\/iY3A7GMcfjVPTgBrt2gACfN8o6UUU0DJroBANo25g5xxnmtLw50uP+A\/yoooew\n0f\/Z",
"birthdate": "17-04-1991",
"residence": {
"address1": "STREET ADDRESS",
"lga": "Mainland",
"state": "Lagos"
}
}
},
"updated_at": "2025-03-25T01:03:24.000000Z",
"created_at": "2025-03-25T01:03:24.000000Z",
"id": 2
}
}
}