Business Address Verification

Proof of Address Verification

POST {{baseurl}}/v2/api/verifications/za/business-address

Headers

Name	Type	Description
token*	String	API secret token

Request Body

Field	Type	Description
registrationNumber*	String	Registration number of the business.

BusinessAddress Verification

With this endpoint, you have access to the verification of the client's business address in South Africa.

Business Address Verification Sample Request

{
  "registrationNumber": "201133333323",
  "isConsent": true,
}

Found Response

{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "id": "6696fd1aae3700817d801ad2",
        "status": "found",
        "businessId": "628b38f03ae28a14f52d4bf7",
        "parentId": null,
        "isConsent": true,
        "type": "za_company_address",
        "searchTerm": "201133333323",
        "name": "La Linea CC",
        "registrationNumber": "201133333323",
        "tin": null,
        "jtbTin": null,
        "taxOffice": null,
        "email": null,
        "companyStatus": "In Business",
        "phone": "27112184300",
        "requestedAt": "2024-07-16T23:07:09.667Z",
        "country": "ZA",
        "createdAt": "2024-07-16T23:07:09.966Z",
        "lastModifiedAt": "2024-07-16T23:07:09.966Z",
        "typeOfEntity": "Close Corporation",
        "activity": "MNF: DOLLS AND STUFFED TOYS",
        "registrationDate": "2018-09-19",
        "address": "52 CORLETT DR, JOHANNESBURG, JOHANNESBURG, ZA",
        "state": null,
        "lga": null,
        "city": "JOHANNESBURG",
        "websiteEmail": null,
        "branchAddress": "52 CORLETT DR, JOHANNESBURG, JOHANNESBURG, ZA",
        "headOfficeAddress": null,
        "objectives": null,
        "amlReport": null,
        "adverseMediaReport": null,
        "requestedBy": {
            "firstName": "API",
            "lastName": "User",
            "middleName": "",
            "id": "628b38f03ae28a5a122d4bf3"
        }
    },
    "links": []
}

Error Response

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