Selfie Photo ID Verification

Verify Users Photo ID with their Selfie Image in real time

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

Header

Header	Type	Description
AppId	string	Create an app to get your app ID on dashboard here
Authorization	string	Private/secret key. Use <key> not Bearer <key>

Body parameters

Parameter	Type	Description	Required
selfie_image	string	Base64 value of the selfie image NB: Kindly truncate data:image/jpeg;base64, from the selfie_image object.	required
photoid_image	string	Base64 value of the photoId image NB: Kindly truncate data:image/jpeg;base64, from the photoid_image object.	required
first_name	string	First Name	optional
last_name	string	Last Name	optional

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

Field	Type	Description
entity	object	Contains the response data
entity.selfie	object	Selfie verification results
entity.selfie.confidence_value	number	Confidence score (0-100) indicating how closely the selfie matches the photo ID. 90+ indicates a match
entity.selfie.match	boolean	Whether the selfie matches the photo ID (true if confidence_value >= 90)
entity.selfie.photoId_image_blurry	boolean	Whether the photo ID image was detected as blurry
entity.selfie.selfie_image_blurry	boolean	Whether the selfie image was detected as blurry
entity.selfie.selfie_glare	boolean	Whether glare was detected on the selfie image
entity.selfie.photoId_glare	boolean	Whether glare was detected on the photo ID image
entity.selfie.age_range	string	Estimated age range of the person in the image
entity.selfie.sunglasses	boolean	Whether sunglasses were detected on the person
entity.selfie.card_type	string	Type of ID card detected in the photo ID image
entity.selfie.last_name	object	Last name verification result
entity.selfie.last_name.match	boolean	Whether the last name matches the provided value
entity.selfie.last_name.last_name	string	Last name extracted from the photo ID
entity.selfie.last_name.confidence_value	number	Confidence score (0-100) for the last name match
entity.selfie.first_name	object	First name verification result
entity.selfie.first_name.match	boolean	Whether the first name matches the provided value
entity.selfie.first_name.first_name	string	First name extracted from the photo ID
entity.selfie.first_name.confidence_value	number	Confidence score (0-100) for the first name match