API Name: business-search

Introduction

Business data can be searched using the AfriGIS Business Search API. Businesses, also referred to as enterprises, can include companies, close corporations and co-operatives.

This API allows users to search enterprise data, using different endpoints and several input options in the request parameters. Depending on the endpoint, the results vary.

Clients can search for business, director or auditor details using location based, enterprise or personal information.

Overview

Enterprise search

Requests

Retrieve the enterprise with a specific name or registration number

Clients can use the business name or registration number as input for this request.

 

Search for businesses at a specific location

Input for this search is in the form of a set of latitude and longitude coordinates. All enterprises at the specified location are returned.

 

Specify a larger area for searching enterprises

Coordinates as latitude and longitude with a radius in meters are input to define the area in which businesses must be searched.

 

Search for enterprises at a specific address

The AfriGIS Search place_id or seoid is used as input to for this request. Information for businesses at the specified address are returned.

 

Retrieve the enterprise at a specified land parcel

Input parameters are the cadastral_reference or lpicode of the enterprise to be returned.

 

Results

The results returned from the above endpoints include the short version of the enterprise registration number, basic business information, limited director information and auditor name and number.

Enterprise Details Search

Requests

Retrieve details for a business, its directors or auditors

Search is conducted using the business registration number.

 

Results

Enterprise Details Search

Results return all details available for the specified business.

 

Director Details Search

Returns all the details of directors for a specified enterprise.

 

Auditor Details Search

The auditor details of a specific business are returned.

 

History Details Search

Historical details changes for a specific business are returned.

Director Search

Requests

Search director by ID number

Clients can search business data by providing the ID number of an individual.

 

Results

Limited information for all businesses for which that individual holds the role of director will be returned.

Director Details

Requests

 

Search director for specific enterprise

Business registration number for a specified enterprise is entered in the request.

 

Results

Limited information for the specified business and detailed information for the director is returned.

Authentication

This API makes use of OAuth2 authentication. To integrate, sign up for a free trial account by contacting [email protected]

For detailed integration instructions using OAuth2, please click on the following link: https://developers.afrigis.co.za/oauth2-authentication/

To view technical documentation describing the details of business-search, click on the button below.