Business Verification

POST {{BASE_URL}}/api/v1/business/verification

Headers

Name	Type	Description
Authentication*	String	Authentication token to track who is making the requests.

Request Body

Name	Type	Description
registrationNumbers*	Array	Array of business registration numbers to veify

200: OK

{
    "status": 200,
    "message": "Business data fetched successfully",
    "data": {
        "items": [
            {
                "createdOn": "2024-01-19T16:46:57",
                "updatedOn": "2024-01-19T16:46:58",
                "registrationNumber": "PVT-TSUBXBYD",
                "businessSearchId": "RXM94",
                "searchStatus": "COMPLETED",
                "searchResult": {
                    "records": [
                        {
                            "verified": "true",
                            "status": "registered",
                            "registrationNumber": "PVT-TSUBXBYD",
                            "registrationDate": "9 April 2014",
                            "postalAddress": "1312 - 00100",
                            "physicalAddress": "CAMP DAVID",
                            "phoneNumber": "[phone]",
                            "email": "[e-mail]",
                            "businessName": "SODAPOP INC",
                            "branch": null,
                            "partners": [
                                {
                                    "type": "director_shareholder",
                                    "name": "JANE DOE",
                                    "idType": "citizen",
                                    "idNumber": "12345678",
                                    "shares": [
                                        {
                                            "name": "ORDINARY",
                                            "shareCount": "50"
                                        }
                                    ]
                                },
                                {
                                    "type": "director_shareholder",
                                    "name": "SODAPOP CURTIS",
                                    "idType": "citizen",
                                    "idNumber": "11223344",
                                    "shares": [
                                        {
                                            "name": "ORDINARY",
                                            "shareCount": "100"
                                        }
                                    ]
                                }
                            ],
                            "shareCapital": [
                                {
                                    "name": "ORDINARY",
                                    "shareCount": 1000,
                                    "nominalValue": 1000.0
                                }
                            ]
                        }
                    ],
                    "count": 1
                }
            }
        ]
    }
}

Business verification request Example

{
    "registrationNumbers": ["PVT-EYUBQBYR"]
}