Skip to main content
Developer Platform

Validifyx API

Add NIN and biometric verification to your product with a few lines of code — REST endpoints, signed webhooks and SDK-friendly schemas.

API Documentation

Reference-first docs with typed schemas for every request and response.

Authentication

Bearer-token auth with scoped API keys and per-environment access.

Verification Endpoints

Create, retrieve and list verifications; fetch trust profiles by ID.

Webhook Events

Signed webhooks for verification.completed, .failed and .expired.

Rate Limits

Fair-use limits with burst allowance — higher tiers for enterprise.

Status & Uptime

Live status page and historical uptime for every API surface.

Create a verification
curl -X POST https://api.validifyx.com/v1/verifications \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "purpose": "employment",
    "recipient": { "phone": "+2348012345678" }
  }'
Receive a webhook
POST https://your-app.com/webhooks/validifyx
X-Validifyx-Signature: t=...,v1=...

{
  "event": "verification.completed",
  "data": {
    "id": "vf_9f8...",
    "status": "verified",
    "trust_profile": "tp_a12..."
  }
}

Start building on Nigeria's trust network

Request developer access and get sandbox keys, sample payloads and integration support from our team.

Request Developer Access