Skip to main content
POST
/
identity
/
nin
/
verify
curl --request POST \
  --url https://api.vtulab.com/v1/identity/nin/verify \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
    "nin": "12345678901",
    "is_consent": true,
    "mode": "basic"
  }'

{
  "status": true,
  "message": "NIN Verified Successfully",
  "data": {
    "transaction": {
      "title": "NIN Verification",
      "amount": 100,
      "reference": "VERIFY_65E8F...",
      "status": "success"
    },
    "result": {
      "first_name": "JOHN",
      "last_name": "DOE",
      "middle_name": "JAMES",
      "gender": "M",
      "date_of_birth": "1990-01-01"
    }
  }
}
Verify the identity of individuals using their National Identification Number (NIN). Our API provides access to verified records from the NIMC database.
Consent Required: You must obtain explicit consent from the individual before verifying their NIN. Requests without is_consent: true will be rejected.

​
Verification Modes

We offer two modes of verification to suit your needs:
  • Basic: Returns essential information (Full Name, Gender, Date of Birth).
  • Advanced: Returns comprehensive details including the individual’s photo (Base64).
curl --request POST \
  --url https://api.vtulab.com/v1/identity/nin/verify \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
    "nin": "12345678901",
    "is_consent": true,
    "mode": "basic"
  }'

{
  "status": true,
  "message": "NIN Verified Successfully",
  "data": {
    "transaction": {
      "title": "NIN Verification",
      "amount": 100,
      "reference": "VERIFY_65E8F...",
      "status": "success"
    },
    "result": {
      "first_name": "JOHN",
      "last_name": "DOE",
      "middle_name": "JAMES",
      "gender": "M",
      "date_of_birth": "1990-01-01"
    }
  }
}