KYB - Best Practices

This guide will walk through some best practices for the Business Verification product.


  1. You have followed the [Quick Start guide] (doc:quick-start) or have existing knowledge of the [Trulioo Platform API] (ref:introduction)

  2. You have tested your credentials using the [Test Authentication] (ref:testauthentication) call

Using Search and Verify APIs

In order to get the best results, it is important to collect the right information from your customers at the time of onboarding. Trulioo recommends using the Search and Verify capabilities to ensure the information provided is complete and error-free. The search and verify workflow allows you to search for the business using the name and then verify the information using the verification method.

Recommended Journey:

  1. Collect the Business Name and Business Registration Number / Identification Number from your customers

If you only have the Business Name, call the Search API and provide the returned information back to your customer to identify and confirm

  1. Call the Verification API with the Business Name, Registration Number, and Jurisdiction (where applicable)

  2. Once the business is verified, the onboarding process is complete

View Previous Transactions

All verifications performed on the Trulioo Platform are logged as a transaction, so that each request received by the Trulioo Platform API leaves a record. The unique identifier for each record is the TransactionRecordID, which is returned as part of the Verify response. For users who want to review historical verification requests, the Trulioo Platform has the following endpoints that access details of a particular record by TransactionRecordID:

Use Get Transaction Record to retrieve a full record of the request and response for a verification performed using the verify method. The response for this method includes the same information as the verify method's response, along with data present in the input fields of the verify request.

Note:Trulioo does not retain sensitive, Personally Identifiable Information, so it is possible that some data elements of previous transactions are scrubbed when using the above methods.

Document Availability

Information varies per country and company. Information within these documents is only available after the document is successfully delivered.

Will the Shareholder Document include shareholder information?

The document title and its content vary per country and jurisdiction. To provide the best user experience, Trulioo uses the normalized the field name "Shareholder List Document". To achieve this normalization, the Trulioo Platform maps a list of document types to the ShareholderListDocument field. It is done based on a sample size of reviewed documents that contains shareholder information. However, availability of this information may be different from one company to another.

Are shareholder documents available for every country Trulioo currently supports?

No, below is the list of documents by country which are available for retrieval

CanadaVarious (Corporate Profile from Federals / State registries)ShareholderListDocument
FranceAnnual AccountsFinancialInformationDocument
FranceRegister CheckShareholderListDocument
Hong KongAnnual AccountsFinancialInformationDocument
Hong KongAnnual ReportAnnualReport
Hong KongArticles of AssociationShareholderListDocument
Hong KongRegistration DetailsRegistrationDetails
JapanRegister ReportRegisterReport
ThailandAnnual AccountsFinancialInformationDocument
ThailandRegistration DetailsRegistrationDetails
United KingdomAnnual AccountsFinancialInformationDocument
United KingdomArticles of AssociationArticleOfAssociation
United KingdomAnnual ReportAnnualReport
United KingdomCapital DocumentCapitalDocument
United KingdomMortgage DocumentMortgageDocument
United KingdomLiquidation DocumentLiquidationDocument

If the country supports document request, does this mean it's available for every company?

No, coverage of documents is only available from the Government Registry sources. When you make a request to the Trulioo Platform API, a check is done in real time to see if the document is available. If the document is available, the Trulioo Platform will retrieve and deliver the document .

Document Request Time

Processing time varies per government registry. It may take anywhere between 10 seconds to a few hours to request the document. Trulioo recommends that customers provide a callback URL with their request so a notification can be sent when the transaction is complete. Documents requested in Canada are only available within the province's business hours. Below is the list of processing time for documents request in Canada.

JurisdictionWeekdays Hours (EST)Saturday (EST)Sunday (EST)
Alberta8:15 am to 11:45 pm8:15 am to 11:45 pm8:15 am to 11:45 pm
British-Columbia**9:00 am to 1:00 am9:00 am to 1:00 amClosed
Federal24 Hours24 Hours24 Hours
Manitoba24 Hours24 Hours24 Hours
New Brunswick24 Hours24 Hours24 Hours
Newfoundland24 Hours24 Hours24 Hours
Northwest Territories8:00 am to 8:00 pm10:00 am to 6:00 pmClosed
Nova Scotia8:00 am to 8:00 pm10:00 am to 5:00 pmClosed
Nunavut*8:30 am to 8:00 pm10:00 am to 6:00 pmClosed
Ontario24 Hours24 Hours24 Hours
Prince Edward Island8:30 am to 8:00 pm10:00 am to 6:00 pmClosed
Quebec24 Hours24 Hours24 Hours
Saskatchewan24 Hours24 Hours24 Hours
Yukon24 Hours24 Hours24 Hours

* Reports in Nunavut are manually provided by the registry staff, obtaining the reports takes between 24h to 48h.
** British Columbia registry does not guarantee access to the Corporate Profile reports on Sundays.
Note: if a manual intervention is required at a registry level, obtaining the report may be delayed.

Can the processing time for document request be sped up?

No, the Trulioo Platform only handles the request and response on behalf of customers. These restrictions are provided by the Government Registry.