> ## 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.

# Verify BVN with Selfie Image

> Lookup and Verify Users BVN with their Selfie Image.

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 inputting the BVN is who they say they really are

### Request

```http [POST] theme={null}
{{baseUrl}}/api/v1/kyc/bvn/verify

```

### Header

| Header        | Type   | Description                                                                                         |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| 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 and pass only the buffer starting with **/9**. | required |
| bvn           | string | A Valid BVN Number                                                                                                                                            | required |

<Info>
  **Confidence Values range from 0% to 100%**

  * 0% - 90% denote match value is false
  * 90% - 100% denote match value is true
</Info>

### Response

```json Response theme={null}
 {
    "entity": {
        "bvn": "1234567890",
        "first_name": "JOHN",
        "middle_name": "DOE",
        "last_name": "MUSA",
        "date_of_birth": "01-January-1907",
        "phone_number1": "08103817187",
        "phone_number2": "",
        "gender": "Male",
        "image": "/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKD...",
        "selfie_verification": {
            "confidence_value": 99.99620056152344,
            "match": true
        },
        "selfie_image_url": "https://image-rekognitions.s3.amazonaws.com/bvn_n_selfie_172.jpg"
    }
} 
```

### Response Fields

| Field                                         | Type    | Description                                                                     |
| --------------------------------------------- | ------- | ------------------------------------------------------------------------------- |
| entity                                        | object  | Contains the BVN verification response data                                     |
| entity.bvn                                    | string  | The Bank Verification Number                                                    |
| entity.first\_name                            | string  | First name of the BVN holder                                                    |
| entity.middle\_name                           | string  | Middle name of the BVN holder                                                   |
| entity.last\_name                             | string  | Last name of the BVN holder                                                     |
| entity.date\_of\_birth                        | string  | Date of birth of the BVN holder (DD-MMMM-YYYY, e.g., 01-January-1907)           |
| entity.phone\_number1                         | string  | Primary phone number associated with the BVN                                    |
| entity.phone\_number2                         | string  | Secondary phone number associated with the BVN (may be empty)                   |
| entity.gender                                 | string  | Gender of the BVN holder                                                        |
| entity.image                                  | string  | Base64-encoded photo from the BVN record                                        |
| entity.selfie\_verification                   | object  | Selfie verification result comparing the submitted selfie to the BVN photo      |
| entity.selfie\_verification.confidence\_value | number  | Confidence score of the selfie match (0–100). Values below 90 indicate no match |
| entity.selfie\_verification.match             | boolean | Whether the selfie matches the BVN photo (`true` if confidence ≥ 90)            |
| entity.selfie\_image\_url                     | string  | URL of the uploaded selfie image stored on S3                                   |

### Test Credentials for Sandbox

Kindly use this Test BVN in sandbox Environment

bvn = `22222222222`