Advanced Phone Number Search

Advanced Phone Number Search API

Advanced phone number search allows you to verify a phone number registered with an NIN from the NIMC database and return the details of the NIN. To perform an advanced phone number search, make a POST request to the following endpoint;

{{baseurl}}/api/v1/identities/ng/nin-phone

Data Validation for Advanced Phone Search

Data validation for advanced phone search allows you to validate the information returned from the phone number search against the data parameters you provided during the verification request. You can validate the first_name, last_name, and date_of_birth by passing this information in the request body to get a true or false response on whether they match the information in the database. Use the same endpoint above to make this request.

Facial Matching for Advanced Phone Search

Facial matching for advanced phone number search enables you to compare the phone number owner’s image in the government database against the image provided when the verification request was made. A confidence score of how well the images match will be returned. Use the same endpoint above to make this request.


The request body should have the following parameters:

{
  "id": "08000000000",
  "verification_consent": true
}
{
   "id": "08000000000",
   "verification_consent": true,
   "validation": {
       "first_name": "John",
       "last_name": "Doe",
       "date_of_birth": "1988-04-04"
   }
}
{
   "id": "08000000000",
   "verification_consent": true,
   "validation": {
       "first_name": "John",
       "last_name": "Doe",
       "date_of_birth": "1988-04-04",
       "selfie": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ"
   }
}

The fields in this request include:

FieldData TypeDescription
idStringRequired - the ID number
verification_consentBooleanRequired - this indicates that subject has given consent to perform this verification. This must be true for the check to be performed.
validation.first_nameStringOptional (required for data matching) - the first name of the ID holder to be compared with ID information in the government database.
validation.last_nameStringOptional (required for data matching) - the last name of the ID holder to be compared with ID information in the government database.
validation.date_of_birthStringOptional (required for data matching) - the date of birth of the ID holder to be compared with ID information in the government database.
validation.selfieStringOptional (required for facial matching) - the selfie/photo of the ID holder to be compared with ID information in the government database.

The response to this request would look like this:

{
   "status": true,
   "message": "NIN phone verified successfully",
   "data": {
       "reference": "VR-O8HfVQC8UxpXnvhlx",
       "id": "08000000000",
       "id_type": "ng_nin_phone",
       "first_name": "Bimbo",
       "last_name": "Olakunle",
       "middle_name": "Doherty",
       "date_of_birth": "1988-04-04",
       "phone_number": "08000000000",
     	 "nin": "55555555555",
       "address": {
           "town": "SULEJA",
           "lga": "Suleja",
           "state": "Niger",
           "street": "13B Sample Street, Ilupeju, Niger State"
       },
       "email": "[email protected]",
       "birth_state": "Edo",
       "birth_lga": "Esan West",
       "birth_country": "nigeria",
       "next_of_kin_state": "Niger",
       "religion": "christianity",
       "gender": "female",
       "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ",
       "signature": "data:image/jpg;base64,/9j/4AAQSkZJRgABAQAAAQ",
       "validation": {
           "first_name": {
               "value": "Viola",
               "match": false
           },
           "last_name": {
               "value": "doe",
               "match": false
           },
           "date_of_birth": {
               "value": "1988-10-16",
               "match": false
           },
           "selfie": {
               "value": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ",
               "match": true,
               "confidence_rating": 94
           }
       },
       "requested_by": "API User"
   }
}