NIN Lookup

post https://sandbox-api.oneliquidity.technology/compliance/v1/gov/ng/nin

This endpoint provides integrators with the ability to verify the identity of their clients through the National Identity Management Commission (NIMC) database.

{
  "firstName": "DOE",
  "lastName": "JOHN",
  "dateOfBirth": "1962-12-28",
  "vnin": "7217264645450618",
  "verificationId": "c61060e9-635a-5392-b39d-b1c27479d67c"
}

Response Sample

The result of this endpoint is sent to the integrator's webhook URL.
An example response is given below:

{
  "event": "COMPLIANCE_NIN_EVENT",
  "message": "NIN validated successfully",
  "data": {
      "id": "ea4fe58c-6504-4991-80be-066fc22c56c3",
      "status": "complete",
      "profession": "STUDENT",
      "lastName": "Fola",
      "nextOfKin": {
          "firstName": "Bola",
          "lastName": "Frank",
          "town": "AWKA",
          "address2": "",
          "address1": "10 Downing Street.",
          "lga": "Awka North",
          "middleName": "Ibrahim",
          "state": "Anambra"
      },
      "gender": "m",
      "stateOfOrigin": "Anambra",
      "dateOfBirth": "11-03-1932",
      "title": "mr",
      "religion": "christianity",
      "firstName": "Chukwuma",
      "nationality": "Nigerian",
      "nspokenlang": "IGBO",
      "birthState": "Anambra",
      "phone": "07030500129",
      "placeOfOrigin": "AWKA",
      "provider": "metamap",
      "lgaOfOrigin": "Awka South",
      "birthCountry": "nigeria",
      "middleName": "Chioma",
      "residence": {
          "address1": "10 Downing Street.",
          "lga": "Awka North",
          "state": "Anambra"
      },
      "email": "[email protected]",
      "height": "****"
    }
}