API ReferenceVerifications
Get verification by ID
Retrieve a specific verification by its ID.
GET
/v1/verifications/{id}Authorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
id*string
Response Body
application/json
curl -X GET "https://example.com/v1/verifications/string"{ "success": true, "statusCode": 200, "message": "Request processed successfully", "timestamp": "2025-10-20T16:30:00.000Z", "path": "/v1/auth/register", "data": { "id": "ver_abc123", "organisationId": "org_xyz789", "status": "SUCCESS", "type": "NIN", "accessLevel": "Premium", "sessionId": "sess_123456789", "source": "WEB", "log": "[2025-10-20T12:00:00.000Z] Verification initiated", "cost": 150.5, "meta": { "userId": "user123", "ipAddress": "192.168.1.1" }, "referenceId": "req_abc123", "createdAt": "2025-10-20T12:00:00.000Z", "updatedAt": "2025-10-20T12:05:00.000Z" }}Get verification export status
Retrieve the current status of a verification export and a download link when available.
BVN Basic Lookup
Verify a BVN number and retrieve basic identity data (name, date of birth, gender, phone). Requires a valid Idempotency-Key header for live-mode API keys to prevent duplicate charges.