Request Body (JSON)

{
    "success": true,
    "message": "IPE clearance request submitted successfully.",
    "reference": "IPE-1727702819-ABC1",
    "tracking_id": "0T3NU7RSKMCHTT4",
    "status": "processing",
    "amount_charged": 1500.00,
    "comment": "Request queued for automated clearing"
}

Check the live clearance status, NIMC remarks, clearing comments, or retrieve the official clearance slip download URL. Also supports POST with {"reference": "..."} or {"tracking_id": "..."}.

Path / Query Parameters

{
    "success": true,
    "reference": "IPE-1727702819-ABC1",
    "service_type": "IPE",
    "service_field": "IPE Clearance",
    "tracking_id": "0T3NU7RSKMCHTT4",
    "status": "successful",
    "comment": "IPE Cleared successfully by NIMC portal",
    "file_url": "https://irust.ng.smartidea.com.ng/storage/project-files/nin-ipe/clearance_slip.pdf",
    "amount": 1500.00,
    "submission_date": "2026-09-30T13:40:00Z",
    "updated_at": "2026-09-30T13:55:12Z"
}

Request Body (JSON)

{
    "success": true,
    "message": "NIN modification request submitted successfully.",
    "reference": "NM20260930143210ABC1",
    "nin": "12345678901",
    "service_field": "Name Modification",
    "status": "pending",
    "amount_charged": 3000.00,
    "comment": "Request submitted and pending admin review"
}

Check the attestation status, NIMC approval stage, or download the updated NIN modification slip. Also supports POST with {"reference": "..."} or {"nin": "..."}.

Path / Query Parameters

{
    "success": true,
    "reference": "NM20260930143210ABC1",
    "service_type": "nin_modification",
    "service_field": "Name Modification",
    "nin": "12345678901",
    "status": "processing",
    "comment": "Attestation data verified; awaiting NIMC backend authorization",
    "file_url": null,
    "amount": 3000.00,
    "submission_date": "2026-09-30T14:32:10Z",
    "updated_at": "2026-09-30T14:35:00Z"
}

Request Body (JSON)

{
    "success": true,
    "message": "NIN personalisation request submitted successfully.",
    "reference": "NINP260930143210ABC1",
    "tracking_id": "WN0987654321XYZ",
    "status": "pending",
    "amount_charged": 1500.00,
    "comment": "Submitted for verification"
}

Check the personalisation progress, or download the rendered digital ID card/slip PDF via file_url. Also supports POST with {"reference": "..."} or {"tracking_id": "..."}.

Path / Query Parameters

{
    "success": true,
    "reference": "NINP260930143210ABC1",
    "service_type": "nin_personalization",
    "service_field": "NIN Personalisation",
    "tracking_id": "WN0987654321XYZ",
    "status": "successful",
    "comment": "Personalisation slip generated successfully",
    "file_url": "https://irust.ng.smartidea.com.ng/storage/project-files/nin-personalisation/slip_card.pdf",
    "amount": 1500.00,
    "submission_date": "2026-09-30T14:32:10Z",
    "updated_at": "2026-09-30T15:00:22Z"
}

Request Body (JSON)

{
    "success": true,
    "message": "NIN suspension request submitted successfully.",
    "reference": "SUS-1727702825-XYZ9",
    "nin": "12345678901",
    "status": "pending",
    "amount_charged": 3000.00
}

Check the investigation resolution and official compliance note. Also supports POST with {"reference": "..."} or {"nin": "..."}.

Path / Query Parameters

{
    "success": true,
    "reference": "SUS-1727702825-XYZ9",
    "service_type": "NIN_SUSPENSION",
    "service_field": "NIN Suspension",
    "nin": "12345678901",
    "status": "in-progress",
    "comment": "Consent verified; case assigned to NIMC zonal audit committee",
    "file_url": null,
    "amount": 3000.00,
    "submission_date": "2026-09-30T14:40:00Z",
    "updated_at": "2026-09-30T14:50:00Z"
}

Request Body (JSON)

{
    "success": true,
    "message": "NIN validation request submitted successfully.",
    "reference": "REF-VAL2609301432ABC",
    "nin": "12345678901",
    "status": "processing",
    "amount_charged": 1000.00,
    "comment": "Validation request queued"
}

Check the validation resolution, synchronization confirmation, or error remarks. Also supports POST with {"reference": "..."} or {"nin": "..."}.

Path / Query Parameters

{
    "success": true,
    "reference": "REF-VAL2609301432ABC",
    "service_type": "NIN_VALIDATION",
    "service_field": "NIN Validation (General)",
    "nin": "12345678901",
    "status": "successful",
    "comment": "Record successfully re-indexed and validated on NIMC central database",
    "file_url": null,
    "amount": 1000.00,
    "submission_date": "2026-09-30T14:10:00Z",
    "updated_at": "2026-09-30T14:12:30Z"
}

# 1. Submit IPE Clearance (Only tracking_id is required)
curl -X POST "https://irust.ng.smartidea.com.ng/api/v1/nin/ipe" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "tracking_id": "0T3NU7RSKMCHTT4"
  }'

# 2. Check Request Status via Service Status Endpoint
curl -X GET "https://irust.ng.smartidea.com.ng/api/v1/nin/ipe/status/IPE-1727702819-ABC1" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

# 3. Or Check via Universal Status Endpoint
curl -X GET "https://irust.ng.smartidea.com.ng/api/v1/nin/status/IPE-1727702819-ABC1" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

<?php

use Illuminate\Support\Facades\Http;

$apiKey = 'YOUR_API_TOKEN';
$baseUrl = 'https://irust.ng.smartidea.com.ng/api/v1/nin';

// 1. Submit IPE Request (Only tracking_id is required)
$response = Http::withToken($apiKey)
    ->acceptJson()
    ->post("{$baseUrl}/ipe", [
        'tracking_id' => '0T3NU7RSKMCHTT4',
    ]);

if ($response->successful()) {
    $result = $response->json();
    $reference = $result['reference'];
    echo "Submitted! Reference: {$reference}\n";

    // 2. Poll Status using the service status endpoint
    $statusResponse = Http::withToken($apiKey)
        ->acceptJson()
        ->get("{$baseUrl}/ipe/status/{$reference}");

    print_r($statusResponse->json());
} else {
    echo "Error: " . $response->body();
}

const axios = require('axios');

const API_KEY = 'YOUR_API_TOKEN';
const BASE_URL = 'https://irust.ng.smartidea.com.ng/api/v1/nin';

const client = axios.create({
  baseURL: BASE_URL,
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
    'Accept': 'application/json'
  }
});

async function runNINWorkflow() {
  try {
    // 1. Submit IPE Clearance (Only tracking_id required)
    const res = await client.post('/ipe', {
      tracking_id: '0T3NU7RSKMCHTT4'
    });
    console.log('Submission:', res.data);

    // 2. Check Service Status
    const status = await client.get(`/ipe/status/${res.data.reference}`);
    console.log('Live Status Audit:', status.data);
  } catch (error) {
    console.error('Request failed:', error.response?.data || error.message);
  }
}

runNINWorkflow();

import requests

API_KEY = "YOUR_API_TOKEN"
BASE_URL = "https://irust.ng.smartidea.com.ng/api/v1/nin"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json"
}

# 1. Submit IPE Clearance (Only tracking_id required)
payload = {
    "tracking_id": "0T3NU7RSKMCHTT4"
}

response = requests.post(f"{BASE_URL}/ipe", json=payload, headers=headers)
data = response.json()
print("Submission Response:", data)

# 2. Check Service Status
if data.get("success"):
    ref = data["reference"]
    status_response = requests.get(f"{BASE_URL}/ipe/status/{ref}", headers=headers)
    print("Live Service Status:", status_response.json())