API Reference

Start KYB process

1 - Create a case

Dotfile API use Case to organise each KYC or KYB process.

The first step is to create a case with the create case API endpoint.

You will receive an unique identifier that will be used later for company and individual association.

2 - Search for a Company

Dotfile provides integration to multiple official business data. It
will prevent your user to search for them and auto fill them in the
onboarding form.

Ask your user the country and the company name or registration number and use the Company search API Endpoint.

List of available country is listed in the List available countries API endpoint.

Dotfile will return a list of companies with basic data for your end-user to select the appropriate company.

Then, you can get all data available on a specific company using the Fetch company API endpoint.

3 - Create entities in your case

Based on the result of the company data fetch, you can now create a company and individual objects.

4 - Start check for each entity

For each entity, you can create checks based on your compliance requirements.

Available checks are :

  • for companies :
    • document verification (articles of association, proof of registration, …)
    • AML screening
  • for individuals :
    • Identity verification (ID document, face recognition, liveness proof)
    • AML screening
    • document verification (ID card, passport)

5 - Review check results

Once your users has performed checks, it should be automatically approved or rejected but in some cases, you’ll need to review the results has our certified providers would have stated an error (blurred photo, data comparison,…).

This review can be done on Console App.

Each check have a dedicated process and informations displayed to help your team review and make a granular decision to approve/reject checks. You can find the full documentation here.

If rejected, you can re-create a new check to ask your end user to perform again.

All checks information can be retrieved by API with a GET method or a webhook.

6 - Approve/Reject case

At the end of the process, you can Approve or Reject the overall case based on entities checks performed and their respective results based on your compliance requirements and rules.

This can be performed manually or automatically via API.