Docs
/
Timztech API

GET Balance

GET https://nuvra.com.ng/api/balance/index.php?api_key=YOUR_API_KEY
<?php
// API endpoint URL
$api_url = "https://nuvra.com.ng/api/balance/index.php?api_key=0b9391b20fc116acec3818c";

// Initialize cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

// Execute request
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// Decode and display response
if ($response === false) {
    echo "Error: Unable to connect to the API.";
} else {
    $data = json_decode($response, true);
    if ($http_code === 200 && isset($data['status']) && $data['status'] === 'success') {
        echo "User: " . htmlspecialchars($data['user']) . "\n";
        echo "Balance: ₦" . htmlspecialchars($data['balance']) . "\n";
        echo "Timestamp: " . htmlspecialchars($data['timestamp']) . "\n";
    } else {
        echo "Error: " . htmlspecialchars($data['message'] ?? 'Unknown error') . "\n";
    }
}
?>
Live test response
Response will appear here after entering a valid API key and clicking Try.

NIN (POST)

POST https://nuvra.com.ng/api/nin/index.php
<?php
// API endpoint
$url = "https://nuvra.com.ng/api/nin/index.php";

// Data to send
$data = [
    "api_key" => "9b6b91396fb08a7",   // Replace with valid API key
    "nin"     => "11111121234"     // Replace with a valid NIN number
];

// Initialize cURL
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

// Execute
$response = curl_exec($ch);

// Error or response
if (curl_errno($ch)) {
    echo "cURL Error: " . curl_error($ch);
} else {
    $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    echo "HTTP Code: $http_code\n";
    echo $response;
}

// Close
curl_close($ch);
?>
Live test response
Response will appear here after entering valid details and clicking Try.

NIN V1

POST https://nuvra.com.ng/api/ninv1/index.php
<?php
// API endpoint
$url = "https://nuvra.com.ng/api/ninv1/index.php";

// Data to send
$data = [
    "api_key"  => "dd7dc81c9b6b91396fb08a7", //your valid apikey
    "idNumber" => "44658", //nin number
    "consent"  => true
];

// Initialize cURL
$ch = curl_init($url);

// Options
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

// Execute
$response = curl_exec($ch);

// Error or response
if (curl_errno($ch)) {
    echo "cURL Error: " . curl_error($ch);
} else {
    $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    echo "HTTP Code: $http_code\n";
    echo $response;
}

// Close
curl_close($ch);
?>
Live test response
Response will appear here after entering valid details and clicking Try.

NIN-phone

POST https://nuvra.com.ng/api/nin-phone/index.php
<?php
// API endpoint
$url = "https://nuvra.com.ng/api/nin-phone/index.php";

// Data to send
$data = [
    "api_key" => "dd7b42081c9b6b91", // Replace with valid API key
    "phone"   => "08145678901"       // Replace with a valid test phone number
];

// Initialize cURL
$ch = curl_init($url);

// Options
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

// Execute
$response = curl_exec($ch);

// Error or response
if (curl_errno($ch)) {
    echo "cURL Error: " . curl_error($ch);
} else {
    $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    echo "HTTP Code: $http_code\n";
    echo $response;
}

// Close
curl_close($ch);
?>
Live test response
Response will appear here after entering valid details and clicking Try.

NIN-phone V1

POST https://nuvra.com.ng/api/nin-phonev1/index.php
<?php
// API endpoint
$url = "https://nuvra.com.ng/api/nin-phonev1/index.php";

// Data to send
$data = [
    "api_key"  => "dd7dcfb31cb81c1396fb08a7",
    "idNumber" => "081217",
    "consent"  => true
];

// Initialize cURL
$ch = curl_init($url);

// Options
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

// Execute
$response = curl_exec($ch);

// Error or response
if (curl_errno($ch)) {
    echo "cURL Error: " . curl_error($ch);
} else {
    $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    echo "HTTP Code: $http_code\n";
    echo $response;
}

// Close
curl_close($ch);
?>
Live test response
Response will appear here after entering valid details and clicking Try.

BVN

POST https://nuvra.com.ng/api/bvn/index.php
<?php
// API endpoint
$url = "https://nuvra.com.ng/api/bvn/index.php";

// Data to send
$data = [
    "api_key" => "dd7dcfb31cb42081c9b6", // Replace with valid API key
    "bvn"     => "22127211111"          // Replace with valid BVN
];

// Initialize cURL
$ch = curl_init($url);

// Options
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

// Execute
$response = curl_exec($ch);

// Error or response
if (curl_errno($ch)) {
    echo "cURL Error: " . curl_error($ch);
} else {
    $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    echo "HTTP Code: $http_code\n";
    echo $response;
}

// Close
curl_close($ch);
?>
Live test response
Response will appear here after entering valid details and clicking Try.

NIN Demo

POST https://nuvra.com.ng/api/nin-demo/index.php
<?php
// API endpoint
$url = "https://nuvra.com.ng/api/nin-demo/index.php";

// Data to send
$data = [
    "api_key"   => "dd7d6376b08a7", // your API key
    "provider"  => "doc",
    "firstName" => "TRUSS",
    "lastName"  => "ALIY",
    "dob"       => "DD-MM-YY",
    "gender"    => "MALE",
    "consent"   => true
];

// Initialize cURL
$ch = curl_init($url);

// Options
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

// Execute
$response = curl_exec($ch);

// Handle errors
if (curl_errno($ch)) {
    echo "cURL Error: " . curl_error($ch);
} else {
    echo $response; // raw API response
}

// Close
curl_close($ch);
?>
Live test response
Response will appear here after entering valid details and clicking Try.