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 verification process This helps to significantly reduce the possibility of fraud by confirming the person using your product is the account owner at the validated bank. Note that; Confidence value is used to verify match and values below 80 are considered false.
  • The NIN holder can generate their virtual NIN via the NIMC Mobile App or the NIMC USSD code - _346_3_NIN_EnterpriseCode#.
  • Dojah’s Enterprise code - 1138183
  • The generated VNIN is valid for only 72 hours
  • The vNIN is designed to replace the 11-digit NIN for everyday usage. It is a unique 16-character alphanumeric token comprising 12 digits, sandwiched between 4 alphabets, two on each end, with no correlation to the issuer’s Raw NIN. An example of a vNIN is: AB012345678910YZ.
  • According to NIMC, The VNIN is not to be stored in any database but only used for verifying the NIN holder.

​
Request

[POST]
{{baseUrl}}/api/v1/kyc/vnin/verify
HeaderTypeDescription
AppIdstringCreate an app to get your app ID on dashboard here
AuthorizationstringPrivate/secret key. Use <key> not Bearer <key>

​
Body Parameter

ParameterTypeDescriptionRequired
vnin *stringA uniquely generated virtual ninrequired
selfie_image *stringBase64 value of the selfie imagerequired

​
Response

Response
{
    "entity": {
        "firstname": "John",
        "middlename": "Doe",
        "surname": "Musa",
        "userid": "WXLLUK-1011",
        "gender": "M",
        "photo": "/9j/4AA....",
        "vnin": "EE848965768582SO",
        "telephoneno": "2348012345678",
        "birthdate": "18-05-1992",
        "selfie_verification": {
            "confidence_value": 0,
            "match": false
        }
    }
}

​
Response Fields

FieldTypeDescription
entityobjectContains the vNIN verification response data
entity.firstnamestringFirst name of the NIN holder
entity.middlenamestringMiddle name of the NIN holder
entity.surnamestringSurname of the NIN holder
entity.useridstringUnique user identifier assigned by NIMC
entity.genderstringGender of the NIN holder (M or F)
entity.photostringBase64-encoded photo from the NIN record
entity.vninstringThe virtual NIN used for the verification request
entity.telephonenostringPhone number associated with the NIN record
entity.birthdatestringDate of birth of the NIN holder (DD-MM-YYYY)
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 80 indicate no match
entity.selfie_verification.matchbooleanWhether the selfie matches the NIN photo (true if confidence ≥ 80)