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 to 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: Confidence value is used to verify match and a confidence value from 60 and above shows a successful match else a mismatch. To Verify Photo ID with Selfie Image;

​
Request

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

​
Body parameters

ParameterTypeDescriptionRequired
selfie_imagestringBase64 value of the selfie image NB: Kindly truncate data:image/jpeg;base64, from the selfie_image object.required
photoid_imagestringBase64 value of the photoId image NB: Kindly truncate data:image/jpeg;base64, from the photoid_image object.required
first_namestringFirst Nameoptional
last_namestringLast Nameoptional
Confidence Values range from 0% to 100%
  • 0% - 90% denote match value is false
  • 90% - 100% denote match value is true

​
Response

Response
{
  "entity": {
    "selfie": {
      "confidence_value": 0,
      "match": false,
      "photoId_image_blurry": false,
      "selfie_image_blurry": false,
      "selfie_glare": true,
      "photoId_glare": true,
      "age_range": "26-40 Years",
      "sunglasses": false,
      "card_type": "VOTER'S CARD",
      "last_name": {
			"match": true,
			"last_name": "",
			"confidence_value": 100
		},
		"first_name": {
			"match": true,
			"first_name": "",
			"confidence_value": 100
		}
    }
  }
}

​
Response Fields

FieldTypeDescription
entityobjectContains the response data
entity.selfieobjectSelfie verification results
entity.selfie.confidence_valuenumberConfidence score (0-100) indicating how closely the selfie matches the photo ID. 90+ indicates a match
entity.selfie.matchbooleanWhether the selfie matches the photo ID (true if confidence_value >= 90)
entity.selfie.photoId_image_blurrybooleanWhether the photo ID image was detected as blurry
entity.selfie.selfie_image_blurrybooleanWhether the selfie image was detected as blurry
entity.selfie.selfie_glarebooleanWhether glare was detected on the selfie image
entity.selfie.photoId_glarebooleanWhether glare was detected on the photo ID image
entity.selfie.age_rangestringEstimated age range of the person in the image
entity.selfie.sunglassesbooleanWhether sunglasses were detected on the person
entity.selfie.card_typestringType of ID card detected in the photo ID image
entity.selfie.last_nameobjectLast name verification result
entity.selfie.last_name.matchbooleanWhether the last name matches the provided value
entity.selfie.last_name.last_namestringLast name extracted from the photo ID
entity.selfie.last_name.confidence_valuenumberConfidence score (0-100) for the last name match
entity.selfie.first_nameobjectFirst name verification result
entity.selfie.first_name.matchbooleanWhether the first name matches the provided value
entity.selfie.first_name.first_namestringFirst name extracted from the photo ID
entity.selfie.first_name.confidence_valuenumberConfidence score (0-100) for the first name match