๐Ÿ” Verification Authority PRODUCTION

TAWI API For Secure NIN & BVN Verification and Onboarding Services

๐Ÿ“ Version 1.0.0 | ๐Ÿ• 2026-04-13 21:17:38 WAT

Total Records

10

Active Consumers

1

Today's Requests

0

System Status

โ— ONLINE

๐Ÿ“ก API Endpoints

POST/api/verify
Verify NIN or BVN record. Requires authentication.
Headers: X-API-Key, X-API-Secret, Content-Type: application/json\n\nBody: {"record_type": "NIN", "record_number": "12345678901"}
GET/api/health
Public health check endpoint.
GET/api/stats
System statistics (requires API key).
POST/api/site-b
Site B verification endpoint.

๐Ÿงช Site B API Tester

Simulate Site B calling your verification API. Tests authentication flow including API key, secret, IP whitelist, and rate limiting.

๐Ÿ’ก Tip: Use this to verify your Site B configuration works before deploying Site B.
The API key assigned to Site B
The secret key (not stored, only used for this test)
Test with: 12345678901 (Chinedu Okafor)

๐Ÿงช Quick Test Data

NIN: 12345678901 (Chinedu Okafor)
NIN: 12345678902 (Aisha Bello)
BVN: 22123456789 (Oluwaseun Adeyemi)
BVN: 22123456790 (Ibrahim Abdullahi)

Site B API Key detected: 2940ae8a1f3a...
IP Whitelist: ["198.244.209.74", "102.212.247.186", "197.211.63.165"]

Response

Click "Test Site B API Call" to see results

๐Ÿ”Œ Integration Guide

โš ๏ธ Security Notice: API credentials are provided separately via secure channel. Never commit credentials to version control.

1. Authentication

Include these headers in all API requests:

X-API-Key: [your_api_key]\nX-API-Secret: [your_api_secret]

2. PHP Example (Site B Integration)

<?php\n$ch = curl_init('https://test.youthfarmers.com.ng/api/verify');\ncurl_setopt_array($ch, [\n CURLOPT_RETURNTRANSFER => true,\n CURLOPT_POST => true,\n CURLOPT_HTTPHEADER => ['X-API-Key: your_key', 'X-API-Secret: your_secret', 'Content-Type: application/json'],\n CURLOPT_POSTFIELDS => json_encode(['record_type' => 'NIN', 'record_number' => '12345678901'])\n]);\n$response = curl_exec($ch);

3. Rate Limits

4. Error Codes

200 - Success\n400 - Bad Request\n401 - Unauthorized\n403 - Forbidden\n429 - Too Many Requests\n500 - Internal Server Error

๐Ÿ” Direct API Test Console

Note: You must provide valid API credentials to use the test console.

โ„น๏ธ System Information

PHP Version: 8.3.30
Server: LiteSpeed
Database: 8.0.42
Cache Driver: file
Environment: production
Debug Mode: Disabled

๐Ÿ“Š Recent Audit Log

TimeTypeNumberResult
2026-04-03 18:59:19NIN1234******1โŒ Not Found
2026-04-03 18:55:13NIN1234******1โŒ Not Found
2026-04-03 18:37:11BVN2212******0โŒ Not Found
2026-04-03 18:34:14NIN2212******0โŒ Not Found
2026-04-03 18:05:35NIN1234******1โŒ Not Found
2026-04-03 18:04:30NIN1234******1โŒ Not Found