Authorization

Dojah Inc

Guides

SDKs

Changelog

Dashboard

Dojah uses standard HTTP response codes to indicate the status of a particular request.

Response Codes

Introduction

Below are the list of Dojah Services keywords

Keywords Definition

In today's digital era, the need for robust and reliable Know Your Customer (KYC) solutions is more critical than ever. Dojah, a leading provider of KYC and identity verification services, offers comprehensive solutions to help businesses seamlessly onboard customers while ensuring compliance with regulatory standards.

Use Cases

Sign In

Create an App

Fund Wallet

From the dashboard, you can view and regenerate API keys.

API Keys

Environments

Authorization Guide

Dojah uses webhooks to let your application know when events happen, such as receiving an SMS message. When the event occurs, Dojah makes an HTTP request (usually a POST or a GET) to the URL you configured for the webhook. Dojah's request will include details of the event such as the service type and Webhook Url. Dojah's Webhook services allow you to subscribe for webhooks, Fetch all Webhooks subscription, and Delete a Webhook service.

Subscribe to Service

This endpoint allows you to Fetch All your Application Webhooks

Fetch All Webhooks

This endpoint allows you to Subscribe to Dojah's webhook service

Delete Webhook

Get the full details of a verification using Reference ID

Verification Details

Get the full list of all the verifications on applications

All Verification

The Lookup BVN endpoint returns details of a particular BVN

Lookup BVN

This endpoint returns details of a phone number

Lookup Phone Number

The Lookup NUBAN Status endpoint provides information on the KYC status of the Account Owner

Lookup NUBAN KYC Status

This endpoint allows developers to fetch customers details using the National Identification Number (NIN) of the customer

Lookup NIN

This endpoint verifies a customer's identity using their uniquely generated Virtual NIN (vNIN). The vNIN is generated from NIMC's mobile app

Virtual NIN Lookup

This endpoint returns details of a license number

Lookup Driver's Licence

This endpoint allows you to fetch a person's details using the Voter's Identification Number of the Individual.

Lookup Voters ID

Get account numbers linked to a BVN or Mobile Number

Lookup User Accounts

The Behavioural Analysis API provides an in-depth financial and behavioral assessment based on the account statement of a user. By analyzing the transaction history, spending patterns, income, and other financial activities, the API helps in understanding the user’s financial behavior, risk profile, and overall financial health. This can be particularly useful for financial institutions, credit scoring, risk assessment, and customer segmentation.

Behavioural Analysis

The Credit Summary API provides a comprehensive summary of an individual's credit history, linked to their Bank Verification Number (BVN). This API is designed to give financial institutions, lenders, and credit agencies a quick and accurate overview of a user's creditworthiness, including outstanding loans, repayment history, and overall credit behavior.

Credit Summary

This endpoint allows you to Lookup a Kenya National ID.

Lookup Kenya National ID

Lookup Kenya Passport

This endpoint allows you to Lookup if a Kenya KRA PIN is genuine

Lookup Kenya KRA PIN

This endpoint allows you to Lookup a National ID. You can Lookup with National ID Number (NIN)

This endpoint allows you to verify a Ghana International Passport.

Lookup Ghana Passport

This endpoint allows you to verify a Ghana Driver's License.

Lookup Ghana Driver's License

This endpoint allows you to verify a Ghana Voter ID card.

Lookup Ghana Voter ID

This endpoint allows you to Lookup a Ghana Tax Identification Number for individuals. For businesses see Ghana Business Lookup under Dojah Business.

Lookup Ghana TIN

This endpoint allows you to Lookup Ghana SSNIT ID

Lookup Ghana SSNIT ID

Validate Ghana Unique Digital Addresses For All Locations Across Ghana and This API endpoint allows you to validate unique digital addresses for all locations across Ghana 

Validate Ghana Digital Addresses

This endpoint allows you to Lookup a South African National ID.

SA National ID

Angola National ID

This endpoint allows you to Lookup a Zimbabwe National ID.

Zimbabwe National ID

Zimbabwe Credit Check

This endpoint allows you to Lookup a Zambia National Registration Card.

Zambia National Registration Card

Validate a business's Tax Identification Number with the FIRS

Validate FIRS TIN

This endpoint allows developers to fetch CAC information of customers' company/organization. CAC is a certificate that shows evidence of the company's existence.

Lookup CAC

Verify Users Photo ID with their Selfie Image in real time

Selfie Photo ID Verification

Get approximate address of user's location

Location Reverse GeoCoding

The BVN Match service allows you to verify that an account number, first name, last name and middle name of a user matches their BVN.

Validate BVN

Lookup and Verify Users NIN with their Selfie Image.

Verify NIN with Selfie Image

Lookup and Verify Users BVN with their Selfie Image.

Verify BVN with Selfie Image

Verify end users age or personal information through BVN, account numbers etc.

Age/Identity Verification

Lookup and Verify Users vNIN with their Selfie Image.

Selfie Verification vNIN

Verify US Individual

Verify a British Identity across multiple sources

UK eKYC

This is an Identity verification service for the Canada, It uses Credit Reference Data, Telephone Directory, Passports and ID Card.

Canada eKYC

Liveness Check

Fast and accurate data extraction and verification from about 11000+ Documents with support for 200 Countries

Document Analysis

To ensure that your customer provides valid Photo ID, Images, and Documents, you can allow them to upload a photo Id, image, and Document which you can pass on to the Dojah for Generic optical character recognition process

Generic OCR Service

Submit an address for physical verification of an Individual in Nigeria

Individual Address Verification

Submit an address for physical verification of a business in Nigeria

Business Address Verification

Retrieve the details of an address verification requested

Fetch Address Verification Data

Prevent fraudulent Individuals from your platform by screening by via PEP, OFAC, AML, Sanction and Adverse media across 200+ countries and 42800+ databases

Screening Info Individual

Prevent fraudulent businesses from your platform by screening by via PEP, OFAC, AML, Sanction and Adverse media across 200+ countries and 42800+ databases

Screening Info Business

Screen your users email, phone, IP Address and AML screening by via PEP, OFAC, , Sanction and Adverse media across 200+ countries and 42800+ databases before onboarding them

User Screening

IP Screening

Email Check

Phone Check

This endpoint allows you to deliver your transactional messages to your users

Send Messages

This endpoint allows you get the delivery status of messages

Get Message Status

Deliver OTPs to your users via multiple channels such as Whatsapp, voice, sms and Email

Send OTP

Validate OTP

Global Business Search

Global Business Details

Overview

Submit an event for live transaction check

Live Transactions

This endpoint returns the account name linked to an account number

Resolve Nuban

This endpoint allow you to get Nigerian banks and their codes

Fetch Banks

Resolve Card BIN

With this endpoint, your end users can easily buy Airtime across all mobile network

Buy Airtime

Purchase Internet Data from Nigerian mobile networks

Buy Internet Data

 Introduction to Dojah Services and Products

Introducing Dojah

Welcome to the Quick Actions page! It features a checklist designed to help new users easily navigate their dashboard.

Quick Actions

The Individual Lookup feature enables businesses to authenticate their users, whether through a single check or by uploading a batch.

Individual Lookup

The Business Lookup empowers customers to verify their businesses, whether through a single check or by uploading a batch.

Business Lookup

Access the history of every verification conducted in Easy Lookup, whether in Individual Lookup or Business Lookup, by clicking on 'View History'.

Download Lookups

Verifications

Document Analysis is aimed at enhancing user authentication processes with ease and accuracy.

Dojah's Address verification helps businesses manage and improve the quality of their customer address information. Ensuring accurate addresses is vital for efficient shipping, billing, and communication purposes. This guide provides an overview of how our address verification works and how businesses can implement it to maintain accurate address data.

Address Verification

AML Screening

With User screening, businesses have the capability to conduct thorough Anti-Money Laundering (AML) lookups on individual users. This process involves comprehensive checks for any potential matches or correlations between the user's information and the AML watchlist or database.

With business screening, businesses have the ability to conduct comprehensive Anti-Money Laundering (AML) lookups specifically targeted at other businesses. This process enables businesses to evaluate the financial integrity and potential risks associated with their business partners, clients, or third-party entities.

Business Screening

Download Screenings

Easy detect

Creating a flow

Editing a Process

Connecting a flow

Cases and Events

API Report

Messaging Logs

Easy Detect Report

APIs Logs

Billings

Audit logs

Overviews

The Dojah platform has a smooth widget that enables your users to authorize access to their accounts. This widget works effortlessly across various browsers and devices of all sizes.


Status code	Error	Description
200	Successful 💯	Your request was successful.
400	Bad request	Most likely an invalid syntax. Check all parameters.
401	Unauthorized	You are unauthorized for this request. Contact support@dojah.io.
402	Payment Required	Your balance is low, please visit the dashboard to top up
404	Not found	URL not recognized. Check to confirm the right URL. Records/parameters not found
405	Method not found	The request is disabled. Check the URL or rollback recent upgrades.
408	Request timeout	Your request took longer than it should have. Check your internet connection.
424	Failed Dependency	Third Party service Failure
429	Too many requests	You have sent too many requests that has exceeded the rate limit. You need to wait a while.
500,502,503,504	Server error	This is a very rare occurrence where the server is unable to process a request properly. Contact support@dojah.io.

GENERAL

GETTING STARTED

GOVERNMENT DATABASE CHECKS (Individual)

GOVERNMENT DATABASE CHECKS (Businesses)

IDENTITY VERIFICATION SERVICES

BIOMETRIC CHECKS

DOCUMENT ANALYSIS

ADDRESS VERIFICATION

AML (Global)

FRAUD APIS

MESSAGING SERVICES

GLOBAL BUSINESS CHECK

FRAUD MONITORING

GENERAL SERVICES

Response Codes

📘 These responses are grouped into: