API Docs

Go Back Introduction Authentication NIN NIN By Phone Demographic Search Personalise (TrackID) BVN Instant IPE IPE Check Status Instant Validation Validation Check Status CAC

Introduction

Welcome to NIMC VERIFICATION our powerful verification API. Below are the endpoints and request examples to get started.

Authentication

Use your API key in the headers:

Authorization: Bearer nimcJfH5wqJzqPhU50ge8gU0nRj8YkZ603

NIN Verification

Endpoint: 

https://verifytech.com.ng/api/nin/index.php

Request Sample:


$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://yourapi.com/api/nin",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(["nin" => "12345678901", 'consent' => true]),
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_API_KEY",
        "Content-Type: application/json"
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

Response Sample:


{
  "status": true,
  "reportID": "TRX123456789",
  "data": {
    "firstName": "ABIZARRI",
    "middleName": "ABDULLAHI",
    "lastName": "ABEEDAN",
    "mobile": "08062160***",
    "birthState": "Gombe",
    "residence_state": "Kano",
    "town": "Akko",
    "addressLine": "Abuja Quarters, Gombe",
    "gender": "Male",
    "lga": "Akko",
    "birthCountry": "Nigeria",
    "birthLGA": "Akko",
    "idNumber": "12345678901",
    "dateOfBirth": "1996-09-22",
    "image": "base64_encoded_image_string"
  }
}

PHONE Verification

Endpoint: 

https://verifytech.com.ng/api/phone/index.php

Request Sample:


$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://yourapi.com/api/phone",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(["phoneNumber" => "12345678901", 'consent' => true]),
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_API_KEY",
        "Content-Type: application/json"
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

Response Sample:


{
  "status": true,
  "reportID": "TRX123456789",
  "data": {
    "firstName": "ABIZARRI",
    "middleName": "ABDULLAHI",
    "lastName": "ABEEDAN",
    "mobile": "08062160***",
    "birthState": "Gombe",
    "residence_state": "Kano",
    "town": "Akko",
    "addressLine": "Abuja Quarters, Gombe",
    "gender": "Male",
    "lga": "Akko",
    "birthCountry": "Nigeria",
    "birthLGA": "Akko",
    "idNumber": "12345678901",
    "dateOfBirth": "1996-09-22",
    "image": "base64_encoded_image_string"
  }
}

Personalise (TrackID)

BVN Verification

Endpoint: 

https://verifytech.com.ng/api/bvn/index.php

Request Sample:


$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://yourapi.com/api/bvn",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(["bvn" => "12345678901", 'consent' => true]),
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_API_KEY",
        "Content-Type: application/json"
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

Response Sample:





        {
  "status": true,
  "message": {
    "firstName": "USMAN",
    "middleName": "ABDULLAHI",
    "lastName": "DANMUSA",
    "mobile": "08136798166",
    "gender": "Male",
    "birthday": "1996-03-15",
    "photo": "base64_encoded_image_string"
  }
}

Instant IPE

IPE Check Status

Instant Validation

Validation Check Status

CAC Lookup

Demographic Search

Endpoint: 

https://verifytech.com.ng/api/demo/index.php

Request Sample:


$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://yourapi.com/api/demo",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(["firstName" => "Usman", "lastName" => "abdullahi", "middleName" => "Danmusa", 
    "gender => "Male",  "dob => "1996-03-15", 'consent' => true]),
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_API_KEY",
        "Content-Type: application/json"
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

Response Sample:


{
  "status": true,
  "reportID": "TRX123456789",
  "data": {
    "firstName": "ABIZARRI",
    "middleName": "ABDULLAHI",
    "lastName": "ABEEDAN",
    "mobile": "08062160***",
    "birthState": "Gombe",
    "residence_state": "Kano",
    "town": "Akko",
    "addressLine": "Abuja Quarters, Gombe",
    "gender": "Male",
    "lga": "Akko",
    "birthCountry": "Nigeria",
    "birthLGA": "Akko",
    "idNumber": "12345678901",
    "dateOfBirth": "1996-09-22",
    "image": "base64_encoded_image_string"
  }
}