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
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
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
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
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
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
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
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
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
post
/api/companies/za/summary
post

A comprehensive bank account verification report designed for both individual consumers and business entities. This report provides detailed verification results, including account status, identity matches, and compliance information, to support Know Your Customer (KYC) processes and ensure accurate and reliable account validations.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
  • : Business related verification on fields such as the business registration number or director information.
  • : These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body
bank_namestringOptional

The name of the bank associated with the account. Supported banks include: 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.

account_numberstringOptional

The valid account number.

account_typestringOptional

Type of the bank account. Supported values include: unknown, current, savings, transmission, bond, subscriptionshare or cheque.

identity_typestringOptional

Type of identification used. Expected values: 'IDNumber', 'Passport', 'TempIDNumber', 'CompanyRegNumber'.

id_numberstringOptional

The valid identification number corresponding to the identity type. For 'CompanyRegNumber', the expected format is 'XXXX/XXXXXX/XX'.

first_namestringOptional

First name of the account holder or the registered business name.

middle_namestringOptional

Middle name of the account holder.

last_namestringOptional

Last name of the account holder.

initialsstringOptional

Initials of the account holder.

contact_numberstringOptional

Contact phone number of the account holder.

emailstringOptional

Email address of the account holder.

Responses
chevron-right
200Success
application/json
post
/api/v1/bankverification
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
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
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
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
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
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
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
post
/api/v2/businessdetails

Last updated