StreamlineAppearance
Business Name Verification
Introduction
This API is designed to provide an interface that developers can use to search for details of a business or company that is registered with URSB. The details span from director, shareholder, registration details, addresses, annual returns, as well as the digital documents i.e. articles of association, company resolutions, certification of incorporation and registration e.t.c
The API is designed to maximize the efficiency of handling multiple requests, and that is achieved by queuing the requests. Upon receipt of a request, an immediate response is generated, indicating that the request has been received for processing. This response includes a unique identifier for the request, which can be used later to check the status of the request.
This approach is primarily influenced by the unpredictable response times of the URSB API. The business search process involves two steps:
- Send a request to the business search endpoint: The response will include a unique identifier for the request.
- Use the unique identifier to get the status of the request: This can be done by calling the ‘Get request status’ endpoint.
The above step is the same for obtaining annual returns and the list of company documents. Document downloads on the other hand work in a similar way, however a document handle that is a unique number for a particular document is used.
Versions
| API Version | Description |
|---|---|
| 1 | Performs synchronous operations to verify business |
| 2 | Enhancement to provide more detailed information about a business and perform asynchronous operations too |
Version Summary
Changes added to API Version 2
- Asynchronous functionality added
- Get list of Company Files
- Get list of Annual Returns
- Get a Company file in PDF
Sequence diagram
Business use cases
Business Search
View Business Document List
INFO
These can either be general documents or annual returns
View Business Document
