Documentation Index
Fetch the complete documentation index at: https://docs.dojah.io/llms.txt
Use this file to discover all available pages before exploring further.
The Customers module provides a centralized repository of all customers profiled across your verification and fraud monitoring activities. It is where every person or business your platform has verified is stored. Once a verification is completed, whether through your app, website, or API, Dojah automatically creates a customer profile and keeps it there permanently.
Finding a customer
Use the search bar at the top of the page to look up any customer by their name or Customer ID. If you’re not sure of the exact name, type the first few letters, and matching results will appear as you type.
To narrow down the list further, use the two filters below the search bar. The Date filter lets you focus on customers verified within a specific time window. The Apps filter lets you see only customers who came through a specific app integration, which is helpful if you run multiple Dojah-powered flows.
Understanding a customer’s status
Every customer in the list carries a status that tells you the outcome of their most recent verification:
VALID means the identity check passed. The data submitted matched the official government record. This customer has been successfully verified.
INVALID means the check ran but the data didn’t match. For example, the name provided didn’t match the name on the BVN record. The customer exists in the database, but their submitted details were incorrect.
PENDING means the verification is still processing. Refresh the page after a few moments to see the updated result.
Viewing a customer’s full profile
Click on any customer row to open their profile. This is where you see everything Dojah retrieved about that person.
The main area on the right shows the actual data returned from each verification type, organised as tabs. If a customer was verified using their BVN, you’ll see a BVN tab. If they were later checked against AML watchlists, an AML screening tab appears alongside it. Each tab holds the complete data set returned for that check.
Running an additional check on an existing customer
If you need to verify a customer against a second ID type, for example, you originally verified them via BVN and now want to confirm their NIN as well, open their profile and click Lookup Another ID. Select the ID type and enter the number, and the result is returned immediately as a new tab on the same profile. All their verification history stays in one place.