Business Verification

post

Basic bank account verification for South African businesses, returning the verification status, result, and any failure reasons if verification is unsuccessful.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body
registration_nostringOptional

Company registration number. format: 2060/119044/01.

business_namestringOptional

Name of the business.

account_numberstringOptional

Type of the bank account.

account_typestringOptional

Type of bank account. Supported account type: current, savings, transmission, bond, subscriptionshare or cheque.

identity_typestringOptional

The type of identification document provided. Supported ID types: CompanyRegNumber

bank_namestringOptional

Name of the bank associated with the account. Supported banks: ABSA, ACCESS BANK, AFRICAN BANK, BIDVEST BANK, CAPITEC BANK, DISCOVERY BANK, FINBOND MUTUAL BANK, FNB, GRINROD BANK, INVESTEC BANK, MERCANTILE BANK, NEDBANK, SASFIN BANK, STANDARD BANK , TYME BANK and UBANK.

emailstringOptional

Business email address.

contact_numberstringOptional

Business contact number.

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses
chevron-right
200Success
application/json

Response object containing the results of the ID verification process within Akibaone.

StatusstringOptional

The result of the endpoint operation, indicating whether the operation was 'Success' or 'Failed'.

VerificationbooleanOptional

Indicates if the ID verification was successful (true) or not (false).

OutcomeReasonstringOptional

Detailed reason for any verification failure, if applicable.

post
/api/v3/bankverification/business
post

The Know Your Business (KYB) Verification Endpoint is designed to authenticate and validate the legitimacy of businesses by verifying key company information. This process ensures that the business is legally registered and operational, thereby mitigating risks associated with fraudulent entities.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body

Object containing key details for Know Your Business (KYB) validation process.

registration_nostringOptional

The registration number of the company. This should be the local company registration number if the country code is 'za', or the international company number for other country codes. format: xxxx/xxxxxx/xx)

id_numberstringOptional

The personal identification number of the company director, required for additional validation in some jurisdictions.

Responses
chevron-right
200Success
application/json

Response object containing the results of the business verification process within Akibaone.

StatusstringOptional

The result of the endpoint operation, indicating whether the operation was 'Success' or 'Failed'.

VerificationbooleanOptional

Indicates if the business verification was successful (true) or not (false).

post
/api/kyb/verification
post

Retrieve director appointments for South Africa companies, via the CIPC

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body

Request schema for company appointments

registration_nostringOptional

Company registration number

consentbooleanOptional

User consent

Responses
chevron-right
200Success
application/json

Company appointments data

StatusstringOptional
ApplicationIdstringOptional
appointmentsarrayOptional
post
/api/companies/za/appointments
post

Retrieve auditors information for South Africa companies, via the CIPC

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body

Request schema for company auditors

registration_nostringOptional

Company registration number

consentbooleanOptional

User consent

Responses
chevron-right
200Success
application/json

Company auditors information

StatusstringOptional
ApplicationIdstringOptional
auditorsarrayOptional
post
/api/companies/za/auditors
post

Retrieve all South Africa companies associated with a director, via the CIPC

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body

Request schema for director affiliations

id_numberstringOptional

Director ID number

consentbooleanOptional

User consent

Responses
chevron-right
200Success
application/json

Director company affiliations

StatusstringOptional
ApplicationIdstringOptional
companiesarrayOptional
post
/api/companies/za/director-affiliations
post

Verify director appointment to South Africa companies, via the CIPC

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body

Request schema for director profile verification

registration_nostringOptional

Company registration number

id_numberstringOptional

Director ID number

consentbooleanOptional

User consent

Responses
chevron-right
200Success
application/json

Director verification result

StatusstringOptional
ApplicationIdstringOptional
verifiedbooleanOptional
director_infoanyOptional
post
/api/companies/za/director-verification
post

Retrieve e-filing history for South Africa companies, via the CIPC

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body

Request schema for company filing history

registration_nostringOptional

Company registration number

consentbooleanOptional

User consent

Responses
chevron-right
200Success
application/json

Company e-filing history

StatusstringOptional
ApplicationIdstringOptional
filingsarrayOptional
post
/api/companies/za/filing-history
post

Retrieve full company profile for South Africa companies, via the CIPC

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body

Request schema for full company profile retrieval

registration_nostringOptional

Company registration number (format: YYYY/NNNNNN/NN)

consentbooleanOptional

User consent to retrieve company data (must be true)

Responses
chevron-right
200Success
application/json

Full company profile data from CIPC

StatusstringOptional

Operation status

ApplicationIdstringOptional

Request tracking ID

namestringOptional

Company name

numberstringOptional

Company registration number

statusstringOptional

Company status

registration_datestringOptional

Date of registration

company_typestringOptional

Type of company

registered_addressanyOptional
directorsanyOptional
shareholdersanyOptional
post
/api/companies/za/profile
post

Retrieve basic company information for South Africa companies, via the CIPC

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body

Request schema for company basic information

registration_nostringOptional

Company registration number

consentbooleanOptional

User consent

Responses
chevron-right
200Success
application/json

Company basic information from CIPC

StatusstringOptional
ApplicationIdstringOptional
business_namestringOptional
registration_nostringOptional
statusstringOptional
registration_datestringOptional
company_typestringOptional
financial_year_endstringOptional
next_ar_due_datestringOptional
post
/api/companies/za/summary
post

TransUnion database business search

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body
SearchTypestringOptional

This variable is how you will search the TransUnion Dataset, it can be one of these options. Name (Busininess name), RegNo (Business Registration Number), TradingNo (Trust Number), DunsNo (Business Duns Number), VatNo (Business Vat Number), ITNo (Business ITNumber) or BankAccountNo (Business bank account number)

SubjectNamestringOptional

Business name if searchType is equal to Name

RegistrationNostringOptional

Trading Number or Trust number used if searchType is equal to TradingNo

ITNumberstringOptional

Business IT number if searchType is equal to ITNo

DunsNumberstringOptional

Business Duns Number if searchType is equal to DunsNo

VatNumberstringOptional

Business Vat number if searchType is equal to VatNo

BankAccountNumberstringOptional

Business bank account number if searchType is equal to BankAccountNo

TradingNumberstringOptional

Business trading number if searchType is equal to TradingNo

Responses
chevron-right
200Success
application/json
StatusstringOptional

Status of the response

post
/api/commercial/businesssearch
Deprecated
post

INACTIVE/UNAVAILABLE

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body
enterpriseNumberstringOptional

The enterprise number (e.g., K2029000000) is derived from the CIPC registration number (YYYY/NNNNNN/XX). Remove the '/' and last two digits, then prefix the result based on the last two digits: 06 → M (Public/Private Company before 1 May 2010), 07 → K (Public/Private Company after 1 May 2010), 23 → B (Close Corporation), 24-26 → C (Cooperative).

countryCodestringOptional

Optional - Country code Country code as ISO (e.g. ZA)

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses
chevron-right
200Success
application/json
idintegerOptional

A unique identifier for the company.

namestringOptional

The full name of the company.

internationalintegerstringOptional

A unique international identifier for the company.

localintegerstring · nullableOptional

A local identifier for the company.

countryIdintegerOptional

The identifier for the country where the company is registered.

dateCreatedstring · date-time · nullableOptional

The date when the company was created.

dateDisolvedstring · date-time · nullableOptional

The date when the company was dissolved.

accountingAuthorityIdinteger · nullableOptional

The identifier for the accounting authority.

createdAtstring · date-timeOptional

Timestamp of when the record was created.

updatedAtstring · date-timeOptional

Timestamp of when the record was last updated.

alternateNamesstring[]Optional

List of alternate names for the company.

shortNamestring · nullableOptional

The abbreviated or short name of the company.

brandNamestring · nullableOptional

The brand name of the company.

canSellSharesboolean · nullableOptional

Indicates whether the company can sell shares.

addressstringOptional

The physical address of the company.

hasPublicDebtboolean · nullableOptional

Indicates whether the company has public debt.

paysVatboolean · nullableOptional

Indicates whether the company pays VAT.

vatintegerstring · nullableOptional

The VAT integer of the company.

vatDatestring · date · nullableOptional

The date when VAT was applied.

vatCancelDatestring · date · nullableOptional

The date when VAT was cancelled.

paysExciseboolean · nullableOptional

Indicates whether the company pays excise duties.

exciseintegerstring · nullableOptional

The excise integer of the company.

exciseDatestring · date · nullableOptional

The date when excise duties were applied.

exciseCancelDatestring · date · nullableOptional

The date when excise duties were cancelled.

europeanintegerstring · nullableOptional

The European integer for the company.

faxstring · nullableOptional

The fax integer of the company.

websitesstring[]Optional

List of websites associated with the company.

typeIdinteger · nullableOptional

The type identifier for the company.

statusTextstring · nullableOptional

The status text for the company.

post
/api/businessdetails
Deprecated
post

INACTIVE/UNAVAILABLE

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body
enterpriseNumberstringOptional

The enterprise number (e.g., K2029000000) is derived from the CIPC registration number (YYYY/NNNNNN/XX). Remove the '/' and last two digits, then prefix the result based on the last two digits: 06 → M (Public/Private Company before 1 May 2010), 07 → K (Public/Private Company after 1 May 2010), 23 → B (Close Corporation), 24-26 → C (Cooperative).

countryCodestringOptional

Optional - Country code Country code as ISO (e.g. ZA)

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses
chevron-right
200Success
application/json
idintegerOptional
namestringOptional
internationalNumberstringOptional
localNumberstringOptional
countryIdintegerOptional
dateCreatedstring · date-timeOptional
dateDisolvedstring · date-timeOptional
accountingAuthorityIdintegerOptional
createdAtstring · date-timeOptional
updatedAtstring · date-timeOptional
alternateNamesstring[]Optional
shortNamestringOptional
brandNamestringOptional
canSellSharesbooleanOptional
addressstringOptional
hasPublicDebtbooleanOptional
paysVatbooleanOptional
vatNumberstringOptional
vatDatestring · dateOptional
vatCancelDatestring · dateOptional
paysExcisebooleanOptional
exciseNumberstringOptional
exciseDatestring · dateOptional
exciseCancelDatestring · dateOptional
europeanNumberstringOptional
faxstringOptional
websitesstring[]Optional
contactsstring[]Optional
typeIdintegerOptional
statusTextstringOptional
publicDebtAmountstringOptional
subscribedShareCapitalstringOptional
paidShareCapitalstringOptional
phonesstring[]Optional
termsstringOptional
annualAssemblystringOptional
endDateFinancialYearstring · dateOptional
vatRemovalBasisstringOptional
vatRestorationBasisstringOptional
currentEmployeesNumberintegerOptional
sharesValuestringOptional
sharesIssuedstringOptional
sharesClassstringOptional
countyIdintegerOptional
financialYearstringOptional
dateStatusChangestring · date-timeOptional
mailingAddressstringOptional
expirationDatestring · dateOptional
postalCodestringOptional
sharesNotesstringOptional
historicalNamesstring[]Optional
notesstringOptional
registryUpdateDatestring · date-timeOptional
noindexbooleanOptional
activityDescriptionstringOptional
providerIdintegerOptional
hideCompanybooleanOptional
hideAddressbooleanOptional
placeOfFormationstringOptional
updatedAtSitemapstring · date-timeOptional
authorizedCapitalstringOptional
oldInternationalNumberstringOptional
turnoverRankintegerOptional
typestringOptional
accountsstring[]Optional
tagsstring[]Optional
LEIstring[]Optional
CIKstring[]Optional
isLEIIssuerbooleanOptional
companiesRegisteredSameDateintegerOptional
inspectionsstring[]Optional
reviewsstring[]Optional
allReviewsCountstringOptional
allReviewsRatingstringOptional
categoriesstring[]Optional
activitiesstring[]Optional
addressesstring[]Optional
personsstring[]Optional
companyContactPersonsstring[]Optional
financialReportsstringOptional
permitsstring[]Optional
licensesstring[]Optional
subdivisionsstring[]Optional
insolvenciesstring[]Optional
eventsstring[]Optional
historystring[]Optional
linksstring[]Optional
vehiclesstring[]Optional
restrictionsstring[]Optional
courtCasesstring[]Optional
acquisitionsstring[]Optional
securityMeasuresstring[]Optional
companyDocumentsstring[]Optional
filingsstring[]Optional
chargesstring[]Optional
inspectionsCountintegerOptional
permitsCountintegerOptional
licensesCountintegerOptional
subdivisionsCountintegerOptional
insolvenciesCountintegerOptional
eventsCountintegerOptional
historyCountintegerOptional
linksCountintegerOptional
companyVehiclesCountintegerOptional
restrictionsCountintegerOptional
courtCasesCountintegerOptional
acquisitionsCountintegerOptional
securityMeasuresCountintegerOptional
companyDocumentsCountintegerOptional
filingsCountintegerOptional
chargesCountintegerOptional
post
/api/v2/fullbusinessdetails
Deprecated
post

INACTIVE/UNAVAILABLE

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body
enterpriseNumberOrNamestringOptional

Company name or number

countryCodestringOptional

Optional - Country code Country code as ISO (e.g. ZA)

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses
chevron-right
200Success
application/json
namestringOptional

The full name of the company.

shortNamestringOptional

The short name of the company, if available.

brandNamestringOptional

The brand name of the company, if available.

internationalNumberstringOptional

The international number assigned to the company.

countryCodestringOptional

The country code where the company is registered.

post
/api/v2/searchcompanies
Deprecated
post

INACTIVE/UNAVAILABLE

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body
namesstringOptional

Diractors name or company name or enterprise number

countryCodestringOptional

Not required - Country code as ISO (e.g. 'ZA')

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses
chevron-right
200Success
application/json
idintegerOptional
namestringOptional
providerIdstringOptional
countryIdintegerOptional
post
/api/v2/searchdirector
post

CIPC Directorship Search by ID Number, allowing users to find details about directorships associated with a specific South African ID number.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body
id_numberstringOptional

South African ID number

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses
chevron-right
200Success
application/json
StatusstringOptional

The status of the response.

post
/api/searchdirector
post

Retrieve detailed business information, typically used for verifying and validating business credentials.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body
country_codestringOptional

A string representing the customer's known nationalities, formatted as 2-character country codes (e.g., 'ZA' for South Africa). Country codes are as follows: Nigeria = NG and South Africa = ZA.

id_typestringOptional

Id type - BUSINESS_REGISTRATION

business_typestringOptional

The incorporation type of the business. Can be any of the following items: bn - for business name registration co - for private or public limited companies it - for incorporated trustees.

id_numberstringOptional

Business registration number

postal_codestringOptional

The postal code of the business (must be a 5 digit string).

postal_addressstringOptional

The postal address of the business (must be a 4 or 5 digit string).

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us.

Responses
chevron-right
200Success
application/json
signaturestringOptional

Signature

timestampstring · date-timeOptional

Timestamp of the response

IsFinalResultstringOptional

Indicates if this is the final result

directorsobjectOptional
fiduciariesobjectOptional
successbooleanOptional

Success status

post
/api/v2/businessdetails

Last updated