# Bank Account Verification

## Bank Account Verification

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

#### Headers

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

#### Request Body

| Name                                               | Type    | Description                                                                                                                                                                                                   |
| -------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id<mark style="color:red;">\*</mark>               | String  | Users identity number                                                                                                                                                                                         |
| accountDetails<mark style="color:red;">\*</mark>   | Object  | <p>Account details data object e.g<br>"accountDetails":{ "bankBranchCode":"<strong>470010</strong>", "bank":"", "accountNumber":"<strong>1443535328</strong>", "accountType":"<strong>Savings</strong>" }</p> |
| bankBranchCode<mark style="color:red;">\*</mark>   | String  | Account bank branch code                                                                                                                                                                                      |
| bank                                               | String  | Account bank                                                                                                                                                                                                  |
| accountNumber<mark style="color:red;">\*</mark>    | String  | Account number                                                                                                                                                                                                |
| accountType<mark style="color:red;">\*</mark>      | String  | Account Type                                                                                                                                                                                                  |
| isSubjectConsent<mark style="color:red;">\*</mark> | Boolean | Indicate subject has given consent. <mark style="color:red;">`Must be true`</mark>                                                                                                                            |
| data                                               | Object  | Validation data object                                                                                                                                                                                        |
| lastName                                           | String  | Lastname to compare against ID                                                                                                                                                                                |
| firstName                                          | String  | Firstname to compare against ID                                                                                                                                                                               |
| middleName                                         | String  | Middlename to compare against ID                                                                                                                                                                              |
| email                                              | String  | Email to compare against ID                                                                                                                                                                                   |
| phoneNumber                                        | String  | Phone number to compare against ID                                                                                                                                                                            |

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

With this endpoint, you have access to the verification of the client's account numbers for all banks in South Africa.

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

```json
{
    "validations": {
        "data": {
            "firstName": "CONCO",
            "middleName": "",
            "lastName": "",
            "email": "email@email.com",
            "phoneNumber": "0795030317"
        }
    },
    "accountDetails": {
        "bankBranchCode": "470010",
        "bank": "",
        "accountNumber": "1443535328",
        "accountType": "Savings"
    },
    "id": "8203170496089",
    "isSubjectConsent": true
}
```

{% endtab %}
{% endtabs %}

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

```json
{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "id": "645bca7cd80de606cd7e5ad3",
        "validations": {
            "data": {
                "phoneNumber": {
                    "validated": false,
                    "value": "0795030317"
                },
                "fullName": {
                    "validated": true,
                    "value": "CONCO"
                },
                "email": {
                    "validated": false,
                    "value": "bonisiwez466@gmail.com"
                }
            },
            "validationMessages": "Email does not match, Phone Number does not match"
        },
        "parentId": null,
        "status": "found",
        "reason": null,
        "dataValidation": true,
        "identityNumberValid": "No",
        "accountTypeValid": "Yes",
        "accountStatus": "Open",
        "acceptsDebits": "Yes",
        "acceptsCredits": "Yes",
        "accountNumberValid": "Yes",
        "bavRiskOutcome": "Low",
        "isConsent": true,
        "accountNumber": "1443535328",
        "idNumber": "8203170496089",
        "businessId": "628b38f03ae28a14f52d4bf7",
        "type": "zaBAV",
        "allValidationPassed": false,
        "requestedAt": "2023-05-10T16:47:20.552Z",
        "requestedById": "628b38f13ae28a7b742d4bf9",
        "country": "ZA",
        "createdAt": "2023-05-10T16:47:20.938Z",
        "lastModifiedAt": "2023-05-10T16:47:20.938Z",
        "metadata": {},
        "requestedBy": {
            "firstName": "Onyeka",
            "lastName": "Ijeh",
            "middleName": "",
            "id": "628b38f13ae28a7b742d4bf9"
        }
    },
    "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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.youverify.co/know-your-customer-services-kyc/id-data-matching-eidv/south-africa/bank-account-verification.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.