Skip to main content

Verify identity documents

Create document verification sessions through the Dashboard

This guide explains how to use your Falu Dashboard to securely collect and verify identity documents.


You can only create verification sessions on Dashboards in Live Mode.

Presently, you can verify government-issued identity cards from Kenya, Uganda, and Tanzania.

You can manually create document verifications in the Dashboard amd share a link with your users. This method is useful for creating one-off verifications; however, you can achieve a more automated process if you integrate with the Falu Identity API.

Creating document verification sessions through the Dashboard follows three main steps:

  1. Navigate to your Dashboard and create an IdentityVerification.
  2. Share the verification link with your user.
  3. View the verification results in the Dashboard.

1. Create an IdentityVerification

An IdentityVerification is Falu's programmatic representation of a verification. It is an object that details the type of verification (the check to perform) and exposes the verified outputs.

To create a document IdentityVerification in the Dashboard:

  1. Navigate to the Verifications menu in the Identity section of the Dashboard.
  2. Click on Create Verification.
  3. Select Document.
    • [Optional] Limit the document type you want your user to upload.
    • [Optional] Provide a return URL for your user. Could be your website's home page, for example.
  4. Click Create Verification.


  1. Copy the verification URL shown after creating an IdentityVerification successfully.
  2. Share the link with your user.

This verification link will expire 24 hours after creation and is single-use.


Only share links with the user you want to verify.

We do no recommend sending verification links through emails or text messages.

3. View verification results

Once the user submits the requested identity document, it will be processed and an appropriate result returned to you on the Dashboard. Document checks are asynchronous and takes from 1 to 3 minutes to complete. As a result, the verification results are not immediately available. Once processing completes, the IdentityVerificatrion status changes from processing to verified, if successfully completed, or an error is returned.