Developer Docs

Build Identity Verification Into Your App in Minutes

REST API, mobile SDKs, and webhooks — everything you need to verify users, screen for fraud, and stay compliant.

api-call.http
POST /v1/verify/document
Authorization: Bearer sk_live_••••••••••

{
  "document_image": "data:image/jpeg;base64,...",
  "document_type": "passport",
  "country": "NGA"
}

// Response
{
  "status": "verified",
  "confidence": 0.993,
  "document_type": "passport",
  "extracted": {
    "full_name": "Oluwaseun Adeyemi",
    "dob": "1990-01-01",
    "expiry": "2028-03-10"
  }
}

Up and running in 3 steps

01

Get your API key

Sign up and get your test API key from the dashboard instantly. No credit card required.

curl https://api.idveriftrust.com/v1/auth/token \
  -H "X-Api-Key: YOUR_KEY"
02

Make your first call

Send a document image and receive a structured verification result in under 2 seconds.

curl -X POST \
  https://api.idveriftrust.com/v1/verify/document \
  -H "Authorization: Bearer sk_live_..." \
  -d '{"document_type":"passport","country":"NGA"}'
03

Handle the result

Parse the JSON response and use the status, confidence, and extracted fields in your application logic.

if (result.status === 'verified') {
  onboardUser(result.extracted);
}

Core API Endpoints

Everything you need to verify identities, screen for AML, and validate businesses.

POST /v1/verify/document

Verify an identity document (passport, ID, license) and extract structured data with AI-powered confidence scoring.

POST /v1/verify/biometric

Perform liveness detection and face match against a reference photo or document portrait.

POST /v1/aml/screen

Screen a user against global sanctions lists, PEP databases, and adverse media watchlists in real time.

POST /v1/kyb/verify

Verify a business entity and its directors against African and global business registries.

GET /v1/verifications/{id}

Retrieve the full result of a previous verification by its unique ID, including all extracted fields.

GET /v1/verifications

List all verifications for your account with support for pagination, date filters, and status filters.

Official SDKs

Install the library for your language and start verifying in minutes.

JS
Node.js
npm install @idveriftrust/node
View Docs →
PY
Python
pip install idveriftrust
View Docs →
PHP
PHP
composer require idveriftrust/php
View Docs →
GO
Go
go get github.com/idveriftrust/go-sdk
View Docs →
RB
Ruby
gem install idveriftrust
View Docs →
JV
Java
implementation 'com.idveriftrust:java-sdk:1.0'
View Docs →
Sandbox Environment

Test Without Risk

Use our sandbox environment with test API keys to build and validate your integration before going live. No rate limits. No real data.

  • Test document images provided
  • Simulated AML matches
  • Instant sandbox API keys
Sandbox Environment

API Base URL:
  https://sandbox.idveriftrust.com/v1

Test API Key:
  sk_test_4f8a2c1b9d3e...

Test Document:
  POST /v1/verify/document
  { "document_type": "test_pass" }

Expected Result:
  { "status": "verified", "confidence": 1.0 }
Get Started

Ready to integrate?

Join hundreds of African businesses using ID Verif Trust to onboard users securely, prevent fraud, and stay compliant — all from a single API.