Verify NIN

Verify National Identification Numbers (NIN) in real-time against the National Identity Management Commission (NIMC) database. Essential for KYC compliance, user onboarding, and identity verification workflows.

HTTP Request

Query Parameters

Code Examples

const nin = "12345678901";
const response = await fetch(`https://pioe.app/api/v1/verify/nin?nin=${nin}`, {
  headers: {
    "X-API-Key": "your_api_key_here"
  }
});

const data = await response.json();
console.log("Valid:", data.isValid);
console.log("Payload:", data.data);

Success Response

{
  "isValid": true,
  "nin": "12345678901",
  "data": {
    "nin": "12345678901",
    "firstName": "JOHN",
    "lastName": "DOE",
    "dob": "1990-05-15",
    "gender": "male"
  },
  "message": "Verification successful"
}

Error Response

{
  "error": "Missing nin parameter"
}