# Basic Bank Account Verification

## Bank Account Verification

<mark style="color:green;">`POST`</mark> `{{baseurl}}/v2/api/identity/ng/bank-account-number/resolve`

#### 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  | Valid account number                                                               |
| bankCode<mark style="color:red;">\*</mark>         | String  | Bank code gotten from list of banks                                                |
| isSubjectConsent<mark style="color:red;">\*</mark> | Boolean | Indicate subject has given consent. <mark style="color:red;">`Must be true`</mark> |

### <mark style="color:green;">Bank Account Verification</mark>

Bank Account Verification is used to verify the owner of a bank account.

{% tabs %}
{% tab title="Sample Request" %}

```json
{
    "accountNumber": "1000000000",
    "bankCode": "058",
    "isSubjectConsent": true
}
```

{% endtab %}
{% endtabs %}

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

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

```json
{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "id": "6284b245c1f36651d41dc6f3",
        "parentId": null,
        "status": "found",
        "reason": null,
        "dataValidation": false,
        "selfieValidation": false,
        "isConsent": true,
        "idNumber": "1000000000",
        "businessId": "6222a5ed3e7a41c29c031ecc",
        "bankDetails": {
            "accountName": "MICHAEL JOHN DOE",
            "accountNumber": "1000000000",
            "bankName": "Guaranty Trust Bank"
        },
        "type": "bav",
        "requestedAt": "2022-05-18T08:45:58.066Z",
        "requestedById": "6222a5ed3e7a41c29c031ece",
        "country": "NG",
        "createdAt": "2022-05-18T08:45:58.079Z",
        "lastModifiedAt": "2022-05-18T08:45:58.079Z",
        "requestedBy": {
            "firstName": "API",
            "lastName": "User",
            "middleName": "",
            "id": "6222a5ed3e7a41c29c031ece"
        }
    },
    "links": []
}
```

{% endtab %}

{% tab title="Not Found Response" %}

```json
HTTP/1.1 200 OK
{
         "success": true,
         "statusCode": 200,
         "message": "success",
         "data": {
             "parentId": null,
             "status": "not_found",
             "dataValidation": false,
             "selfieValidation": false,
             "isConsent": true,
             "idNumber": "0141258801",
             "businessId": "61d880f1e8e15aaf24558f1a",
             "bankDetails": {
                 "accountName": null,
                 "accountNumber": null,
                 "bankName": null
             },
             "type": "bav",
             "requestedAt": "2022-02-08T01:51:10.746Z",
             "country": "NG",
             "createdAt": "2022-02-08T01:51:10.917Z",
             "lastModifiedAt": "2022-02-08T01:51:10.917Z",
             "id": "6201cc85dce3f50214956971",
             "requestedBy": {
                 "firstName": "Famous",
                 "lastName": "Ehichioya",
                 "middleName": "Prior",
                 "id": "61d880f2e8e15aaf24558f9b"
             }
         },
         "links": []
     }
```

{% endtab %}
{% endtabs %}