Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dojah.io/llms.txt

Use this file to discover all available pages before exploring further.

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
AuthorizationstringPrivate/secret key. Use <key> not Bearer <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
Confidence Values range 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": "Musa",
         "middle_name": "Doe",
         "gender": "M",
         "image": "/9j/4AAQScXJSgBBAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwg...",
         "phone_number": "0812345678",
         "date_of_birth": "1993-05-06",
         "nin": "7*****56789",
         "selfie_verification": {
             "confidence_value": 99.90354919433594,
             "match": true
         }
    }
}

​
Response Fields

FieldTypeDescription
entityobjectContains the NIN verification response data
entity.first_namestringFirst name of the NIN holder
entity.last_namestringLast name of the NIN holder
entity.middle_namestringMiddle name of the NIN holder
entity.genderstringGender of the NIN holder
entity.imagestringBase64-encoded photo from the NIN record
entity.phone_numberstringPhone number associated with the NIN record
entity.date_of_birthstringDate of birth of the NIN holder (YYYY-MM-DD)
entity.ninstringThe National Identification Number
entity.selfie_verificationobjectSelfie verification result comparing the submitted selfie to the NIN photo
entity.selfie_verification.confidence_valuenumberConfidence score of the selfie match (0–100). Values below 90 indicate no match
entity.selfie_verification.matchbooleanWhether the selfie matches the NIN photo (true if confidence ≥ 90)

​
Test Credentials for Sandbox

Kindly use this Test NIN in sandbox Environment nin = 70123456789