Identity Biometrics

Identity Verifications with biometrics

The maximum image size we accept is 1MB

Verify Identity with biometrics

POST https://vapi.verifyme.ng/v1/verifications/identities/biometrics

This endpoint is to fetch identity details with the identity type, number and either one of photo_url or photo field. PS: Either one of the photoUrl or photo has to be provided.

Headers

Name	Type	Description
Authorization	string	Authorization token

Request Body

Name	Type	Description
photoUrl	string	URL link to image file.
photo	object	Form Data image
idType	string	Identity Type ( nin , frsc or bvn )
idNumber	string	Identity Number

200

{
    "status": "success",
    "data": {
        "bvn": "10000000001",
        "firstname": "John",
        "lastname": "Doe",
        "middlename": "Favor",
        "gender": "Male",
        "phone": "080000000001",
        "birthdate": "08-03-1992",
        "nationality": "Nigerian",
        "photo": "base64 image",
        "photoMatching": {
            "match": true,
            "matchScore": 99.899765,
            "matchingThreshold": 80,
            "maxScore": 100
        }
    }
}

404 Identity not found ( eg bvn )

{
    "code":"NOT_FOUND_ERROR",
    "message":"BVN provided is not found. Please provide a valid bvn"
}

Sample Request

Curl

curl -i -X POST -H "Content-Type: multipart/form-data" 
-H "Authorization: Bearer <your_auth_token>"
-F “idNumber=10000000001”
-F “idType=nin”
-F “photo=@your_photo.jpg”
-F “photoUrl=<your_image.com>”
 https://vapi.verifyme.ng/verifications/identities/biometrics