To ensure that your customer is who they say they are, you can allow them take a selfie photo which you can pass on to the Dojah for the verification process This helps to significantly reduce the possibility of fraud by confirming the person who is inputting the National ID number is who they say they really are.

​
Request

[POST]
{{baseUrl}}/api/v1/kyc/nin/verify
HeaderTypeDescription
AppIdstringCreate an app to get your app ID on dashboard here
Authorizationstringpublic secret key

​
Body Parameters

ParameterTypeDescriptionRequired
last_name OPTIONALstringLast Nameoptional
first_name OPTIONALstringFirst Nameoptional
selfie_image REQUIREDstringBase64 value of the selfie image. NB: Kindly truncate data:image/jpeg;base64, from the selfie_image object and pass only the buffer starting with /9.required
nin REQUIREDstringNational Identity Verification Number.required

​
📘 NB : Confidence Values ranges from 0% to 100 %

0% - 90% denote match value is false
90% -100% denote match value is true

​
Response

Response
{
    "entity": {
         "first_name": "John",
         "last_name": "Doe",
         "middle_name": "Chinwe",
         "gender": "M",
         "image": "/9j/4AAQScXJSgBBAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwg...",
         "phone_number": "0812345678",
         "date_of_birth": "1993-05-06",
         "nin": "70123456789",
         "selfie_verification": {
             "confidence_value": 99.90354919433594,
             "match": true
         }
    }
}

​
Test Credentials for Sandbox

Kindly use this Test NIN in sandbox Environment nin = 70123456789