Business Verification

post

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

Required 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
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.

Required 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
post
/api/kyb/verification
post

Get basic information about a company, such as its name, registration number, and status. ⚠️ Note: This service availability is affected by a recent outage at CIPC, we are engaging to resolve.

Required 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
enterprise_numberstringOptional

Company registration number. format: 2060/119044/01

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
post
/enterprise/basicinformation
post

List all directors associated with a company, including their roles and appointment dates. ⚠️ Note: This service availability is affected by a recent outage at CIPC, we are engaging to resolve.

Required 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
enterprise_numberstringOptional

Company registration number. format: 2060/119044/01

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
post
/enterprise/companydirectors
post

Retrieve the filing history of annual returns for a company, showing compliance with regulatory requirements. ⚠️ Note: This service availability is affected by a recent outage at CIPC, we are engaging to resolve.

Required 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
enterprise_numberstringOptional

Company registration number. format: 2060/119044/01

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
post
/enterprise/efilinghistory
post

Retrieve the full company profile, including detailed information about the company's structure, operations, and key data points. ⚠️ Note: This service availability is affected by a recent outage at CIPC, we are engaging to resolve.

Required 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
enterprise_numberstringOptional

Company registration number. format: 2060/119044/01

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
post
/enterprise/companyprofile
post

Obtain detailed information about an individual director’s appointment within a company. ⚠️ Note: This service availability is affected by a recent outage at CIPC, we are engaging to resolve.

Required 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
enterprise_numberstringOptional

Company registration number. format: 2060/119044/01

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
post
/enterprise/directorprofile
post

Get details of an individual company director's appointment using their identity number for verification. ⚠️ Note: This service availability is affected by a recent outage at CIPC, we are engaging to resolve.

Required 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
identity_numberstringOptional

Director's identity 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
post
/enterprise/directorverification
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.

Required 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
post
/api/v1/bankverification
post

TransUnion database business search

Required 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
post
/api/commercial/businesssearch
post

Get complete information about the company, such as contacts, financial statements, court cases and other. ⚠️ Note: The service is currently unavailable. We are working to resolve this issue

Required 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
post
/api/businessdetails
post

Get a complete information about the company, such as contacts, financial statements, court cases and other. ⚠️ Note: The service is currently unavailable. We are working to resolve this issue.

Required 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
post
/api/v2/fullbusinessdetails
post

Get a list of global companies that match your query. ⚠️ Note: The service is currently unavailable. We are working to resolve this issue.

Required 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
post
/api/v2/searchcompanies
post

Directorship global search by directors name. ⚠️ Note: The service is currently unavailable. We are working to resolve this issue.

Required 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
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.

Required 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
post
/api/searchdirector
post

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

Required 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
post
/api/v2/businessdetails

Last updated