Developer Documentation

{
    "status": "success",
    "response_code": "00",
    "user_data": {
        "nin": "12345678901",
        "firstName": "JOHN",
        "middleName": "MICHAEL",
        "surname": "DOE",
        "gender": "m",
        "birthDate": "1985-05-15",
        "telephoneNo": "08012345678",
        "photo": "base64_encoded_jpeg..."
    },
    "message": "PDF generated successfully",
    "pdf_base64": "base64_encoded_pdf_data_here..."
}

This is what nin_by_nin.php (Premium) and nin_standard_slip.php (Standard) actually return — identity fields only. There is no trackingId and no address in this shape. If your users need the tracking ID and residential address, see the "Response (Full Details)" tab and use the Regular or VNIN slip endpoint instead.

{
    "status": "success",
    "response_code": "00",
    "user_data": {
        "nin": "12345678901",
        "firstname": "JOHN",
        "surname": "DOE",
        "middlename": "MICHAEL",
        "gender": "m",
        "birthdate": "1985-05-15",
        "telephoneno": "08012345678",
        "trackingId": "ABC1234567890XY",
        "residence_AdressLine1": "123 Sample Street",
        "residence_Town": "Ikeja",
        "residence_state": "Lagos",
        "birthcountry": "Nigeria",
        "birthstate": "Lagos",
        "birthlga": "Ikeja",
        "photo": "base64_encoded_jpeg...",
        "signature": "base64_encoded_jpeg..."
    },
    "message": "PDF generated successfully",
    "pdf_base64": "base64_encoded_pdf_data_here...",
    "transaction_id": "6ada933bafdb83488dc4e92a41da86"
}

Only the Regular Slip (nin_regular_slip.php) and VNIN Slip (vnin_slip.php) endpoints return this shape. This is the complete NIN record, including the real 15-character NIMC trackingId, residential address (residence_AdressLine1, residence_Town, residence_state) and place of birth (birthcountry, birthstate, birthlga). Swap the endpoint URL to nin_regular_slip.php or vnin_slip.php (same request parameters) to get this response. The user_data object is passed through exactly as our upstream provider returns it, so always read fields defensively. Note: the top-level transaction_id is our own internal reference for this request (useful for support lookups) — it is not issued by NIMC. The real NIMC tracking ID is user_data.trackingId.

$apiKey = "YOUR_API_KEY_HERE";
$nin = "12345678901"; // your NIN

$url = 'https://abjiktech.com.ng/api/verification/nin_by_nin.php';

// Make API request
$payload = json_encode([
    'api_key' => $apiKey,
    'nin' => $nin
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Content-Length: ' . strlen($payload)
    ]
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$curlError = curl_error($ch);
curl_close($ch);

// Handle response
if ($curlError) {
    echo "API connection failed: " . $curlError;
    exit;
}

$apiResponse = json_decode($response, true);

if ($apiResponse['status'] === 'success' && !empty($apiResponse['pdf_base64'])) {
    // Decode and save PDF
    $pdfData = base64_decode($apiResponse['pdf_base64']);
    $fileName = "nin_slip_" . $nin . ".pdf";
    file_put_contents($fileName, $pdfData);
    echo "PDF saved successfully: " . $fileName;
} else {
    echo "Error: " . $apiResponse['message'];
}

{
    "status": "success",
    "response_code": "00",
    "user_data": {
        "nin": "12345678901",
        "first_name": "JOHN",
        "last_name": "DOE",
        "middle_name": "MICHAEL",
        "gender": "MALE",
        "date_of_birth": "15-05-1985",
        "phone_number": "08012345678",
        "address": "123 Sample Street, Lagos"
    },
    "message": "PDF generated successfully",
    "pdf_base64": "base64_encoded_pdf_data_here..."
}

{
    "status": "success",
    "response_code": "00",
    "user_data": {
        "response_code": "00",
        "description": "Successful",
        "verificationType": "NIN-VERIFY",
        "verificationStatus": "VERIFIED",
        "transactionStatus": "SUCCESSFUL",
        "transactionReference": 1783936751000,
        "searchParameter": "JOHN DOE",
        "response": [
            {
                "firstname": "JOHN",
                "surname": "DOE",
                "middlename": "MICHAEL",
                "gender": "Male",
                "telephoneno": "08012345678",
                "nin": "12345678901",
                "birthdate": "15-05-1985",
                "photo": "base64_encoded_jpeg_data...",
                "birthcountry": "Nigeria",
                "birthlga": "Example LGA",
                "birthstate": "Example State",
                "residence_AdressLine1": "123 Sample Street",
                "signature": "base64_encoded_image_data...",
                "trackingId": "S7Y0NYF88000A09",
                "residence_Town": "Example Town",
                "residence_state": "Example State"
            }
        ]
    },
    "matches": 1,
    "records": [
        {
            "nin": "12345678901",
            "firstname": "JOHN",
            "surname": "DOE",
            "middlename": "MICHAEL",
            "gender": "Male",
            "birthdate": "15-05-1985",
            "birthlga": "Example LGA",
            "birthstate": "Example State",
            "residence_state": "Example State",
            "page": 1
        }
    ],
    "message": "PDF generated successfully",
    "pdf_base64": "base64_encoded_pdf_data..."
}

$apiKey = "YOUR_API_KEY_HERE";
$firstName = "JOHN";
$lastName = "DOE";
$dob = "1985-05-15"; // yyyy-mm-dd from form
$gender = "MALE";

// Convert DOB from yyyy-mm-dd to dd-mm-yyyy
$formattedDob = date("d-m-Y", strtotime($dob));

$url = 'https://abjiktech.com.ng/api/verification/nin_by_demo.php';

$payload = json_encode([
    'api_key' => $apiKey,
    'firstname' => $firstName,
    'lastname' => $lastName,
    'dob' => $formattedDob,
    'gender' => $gender
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Content-Length: ' . strlen($payload)
    ],
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_SSL_VERIFYHOST => false
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$curlError = curl_error($ch);
curl_close($ch);

if (!empty($curlError)) {
    echo "cURL Error: $curlError";
} elseif ($httpCode !== 200) {
    echo "HTTP Error: $httpCode";
} else {
    $result = json_decode($response, true);
    
    if (!empty($result['pdf_base64'])) {
        $pdfData = base64_decode($result['pdf_base64']);
        $filePath = 'nin_slip_' . time() . '.pdf';
        file_put_contents($filePath, $pdfData);
        echo "PDF saved successfully: $filePath";
    } else {
        echo "Error: " . $result['message'];
    }
}

{
    "status": "success",
    "response_code": "00",
    "user_data": {
        "bvn": "12345678901",
        "first_name": "JOHN",
        "last_name": "DOE",
        "middle_name": "MICHAEL",
        "gender": "MALE",
        "date_of_birth": "15-05-1985",
        "phone_number": "08012345678",
        "address": "123 Sample Street, Lagos"
    },
    "message": "BVN slip generated successfully",
    "pdf_base64": "base64_encoded_pdf_data_here..."
}

{
    "success": true,
    "message": "IPE clearance request submitted successfully. Your request is now pending processing.",
    "data": {
        "transaction_id": "ipe_a1b2c3d4e5f6a1b2c3d4e5f6",
        "tracking_id": "IPE202400001",
        "status": "pending",
        "amount_charged": "500.00",
        "balance_before": "5000.00",
        "balance_after": "5000.00",
        "note": "Your IPE clearance is being processed. You can check the status in your transaction history."
    }
}

HTTP Status: 200 OK

// Insufficient balance
{
    "success": false,
    "message": "Insufficient balance. Your balance is ₦200.00 but IPE clearance costs ₦500.00"
}

// Duplicate tracking ID
{
    "success": false,
    "message": "This tracking ID has already been submitted and is pending processing."
}

// Invalid parameters
{
    "success": false,
    "message": "Invalid trackingID format. Must be 1 to 20 alphanumeric characters."
}

HTTP Status: 400 Bad Request

$apiKey = "YOUR_API_KEY_HERE";
$trackingID = "IPE202400001";

$url = 'https://abjiktech.com.ng/api/verification/ipe_clearance.php';

$payload = json_encode([
    'api_key' => $apiKey,
    'trackingID' => $trackingID
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Content-Length: ' . strlen($payload)
    ]
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);

if ($result['success'] === true) {
    echo "IPE submitted! Transaction ID: " . $result['data']['transaction_id'];
    echo "Status: " . $result['data']['status'];
    echo "Balance after: ₦" . $result['data']['balance_after'];
} else {
    echo "Error: " . $result['message'];
}