# Kenyan Bank Account Verification

## Bank Account Verification

<mark style="color:green;">`POST`</mark> `{{baseurl}}/v2/api/identity/ke/bav`

#### Headers

| Name                                    | Type   | Description      |
| --------------------------------------- | ------ | ---------------- |
| token<mark style="color:red;">\*</mark> | String | API secret token |

#### Request Body

| Name                                            | Type    | Description                                                                      |
| ----------------------------------------------- | ------- | -------------------------------------------------------------------------------- |
| accountNumber<mark style="color:red;">\*</mark> | String  | Candidates bank account number                                                   |
| bankId                                          | String  | Bank ID number                                                                   |
| isSubjectConsent                                | Boolean | Indicate subject has given consent. <mark style="color:red;">Must be true</mark> |

{% tabs %}
{% tab title="Bank Account Verification Sample Request" %}

```json
{
    "bankId": "1",
    "accountNumber": "111111111",
    "isSubjectConsent": true
}
```

{% endtab %}
{% endtabs %}

<mark style="color:red;">Note</mark>: To get the list of banks in Kenya, click [here](https://doc.youverify.co/know-your-customer-services-kyc/id-data-matching-eidv/kenya/kenyan-bank-account-verification/bank-list)

{% tabs %}
{% tab title="Bank Account Verification Sample Response" %}

```json
{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "id": "66ec6b61af44fb8a5574feb2",
        "parentId": null,
        "status": "found",
        "reason": null,
        "dataValidation": false,
        "selfieValidation": false,
        "isConsent": true,
        "idNumber": "111111111",
        "businessId": "62b2e8b281442b03187f7896",
        "bankCode": "1",
        "bankDetails": {
            "accountName": "Mocking Bird Limited",
            "accountNumber": "111111111",
            "bankName": "KCB"
        },
        "type": "keBAV",
        "allValidationPassed": true,
        "requestedAt": "2024-09-19T18:20:20.427Z",
        "requestedById": "62b2e8b381442b75857f7898",
        "country": "KE",
        "createdAt": "2024-09-19T18:20:20.800Z",
        "lastModifiedAt": "2024-09-19T18:20:20.800Z",
        "adverseMediaReport": null,
        "amlReport": null,
        "metadata": {},
        "requestedBy": {
            "firstName": "Abdulazeez",
            "lastName": "Shittu",
            "middleName": "",
            "id": "62b2e8b381442b75857f7898"
        }
    },
    "links": []
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Error Response" %}

```json
{
  "success": false,
  "statusCode": 404,
  "message": "You have attempted to get a resource that does not exist.",
  "name": "ResourceNotFoundError",
  "data": {}
}
```

{% endtab %}
{% endtabs %}