# Business Account Verification

## Business Account Verification

<mark style="color:green;">`POST`</mark> `{{baseurl}}/v2/api/verifications/za/business-account`

#### Headers

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

#### Request Body

| Field                                                  | Type      | Description                                         |
| ------------------------------------------------------ | --------- | --------------------------------------------------- |
| registrationNumber<mark style="color:red;">\*</mark>   | String    | The registration number of the business. (required) |
| businessPayload<mark style="color:red;">\*</mark>      | Object    | The payload containing business details. (required) |
| branchNumber                                           | String    | The branch number.                                  |
| batchNumber                                            | String    | The batch number.                                   |
| enquiryAmount                                          | String    | The enquiry amount.                                 |
| accountVerifications<mark style="color:red;">\*</mark> | Object\[] | The list of account verifications. (required)       |
| accountHolder<mark style="color:red;">\*</mark>        | String    | The account holder's name.                          |
| accountNumber<mark style="color:red;">\*</mark>        | String    | The account number.                                 |
| accountType<mark style="color:red;">\*</mark>          | String    | The account type.                                   |
| branchCode                                             | String    | The branch code.                                    |
| registrationNumber                                     | String    | The registration number.                            |
| bankCodes<mark style="color:red;">\*</mark>            | Object\[] | The list of bank codes.                             |
| accountHolder                                          | String    | The account holder's name.                          |
| accountNumber                                          | String    | The account number.                                 |
| bankAbbreviation                                       | String    | The bank abbreviation.                              |
| branch                                                 | String    | The branch.                                         |
| branchCode                                             | String    | The branch code.                                    |
| creditAmount                                           | String    | The credit amount.                                  |
| specialInstructions                                    | String    | The special instructions.                           |
| termsGiven                                             | String    | The terms given.                                    |
| tradeReferences<mark style="color:red;">\*</mark>      | Object\[] | The list of trade references.                       |
| branch                                                 | String    | The branch.                                         |
| contactName                                            | String    | The contact name.                                   |
| telephoneDialingCode                                   | String    | The telephone dialing code.                         |
| telephoneNumber                                        | String    | The telephone number.                               |
| tradeName                                              | String    | The trade name.                                     |
| isConsent<mark style="color:red;">\*</mark>            | Boolean   | Indicates whether consent is given. (required)      |

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

With this endpoint, you have access to the verification of the client's business account.

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

```json
{
    "registrationNumber": "201133333323",
    "businessPayload": {
        "branchNumber": "88",
        "batchNumber": "11",
        "enquiryAmount": "5000",
        "accountVerifications": [
            {
                "accountHolder": "ITC DISTRIBUTORS PTY LTD",
                "accountNumber": "050610025211",
                "accountType": "CUR",
                "branchCode": "254905",
                "registrationNumber": "197905643207"
            }
        ],
        "bankCodes": [
            {
                "accountHolder": "",
                "accountNumber": "",
                "bankAbbreviation": "",
                "branch": "",
                "branchCode": "",
                "creditAmount": "",
                "specialInstructions": "",
                "termsGiven": ""
            }
        ],
        "tradeReferences": [
            {
                "branch": "",
                "contactName": "",
                "telephoneDialingCode": "",
                "telephoneNumber": "",
                "tradeName": ""
            }
        ]
    },
    "isConsent": true
}
```

{% endtab %}
{% endtabs %}

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

```json
{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "id": "66a7965de3034410d8af076e",
        "status": "found",
        "businessId": "628b38f03ae28a14f52d4bf7",
        "parentId": null,
        "isConsent": true,
        "type": "za_company_account",
        "searchTerm": "201133333323",
        "name": "ITC DISTRIBUTORS (PTY) LTD",
        "registrationNumber": "201133333323",
        "requestedAt": "2024-07-29T13:17:20.029Z",
        "country": null,
        "createdAt": "2024-07-29T13:17:20.303Z",
        "lastModifiedAt": "2024-07-29T13:17:20.303Z",
        "itNumber": null,
        "bankName": null,
        "branchCode": "254905",
        "accountNumber": "050610025211",
        "accountHolder": "ITC DISTRIBUTORS PTY LTD",
        "accountVerification": {
            "verifiedDate": "2024-07-25",
            "accountFound": "Y",
            "idMatch": "N",
            "surnameMatch": "N",
            "accountOpen": "Y",
            "accountDormant": "U",
            "accountOpen3Months": "Y",
            "accountAcceptsDebits": "Y",
            "accountAcceptsCredits": "Y",
            "branchCode": null,
            "errorReason": "Success",
            "verified": "N"
        },
        "websiteEmail": null,
        "branchAddress": null,
        "headOfficeAddress": null,
        "objectives": null,
        "amlReport": null,
        "adverseMediaReport": null,
        "requestedBy": {
            "firstName": "API",
            "lastName": "User",
            "middleName": "",
            "id": "628b38f03ae28a5a122d4bf3"
        }
    },
    "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 %}