IDENTITY VERIFICATION

NIN IPE Verification

Perform an Identity Pattern Extraction (IPE) to fetch deep metadata and historical tracking information associated with a given National Identity Number.

POST /api/v1/nin-ipe

Authentication & Headers

HEADER	VALUE	REQUIRED
`Authorization`	`Bearer YOUR_API_TOKEN`	Yes
`Accept`	`application/json`	Yes

Request Parameters

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`nin`	string	The 11-digit National Identity Number.	Required

Example Request

cURL

curl -X POST "https://www.api.arewasmart.com.ng/api/v1/nin-ipe" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -d "nin=12345678901"

Success Response (IPE)

{
    "status": true,
    "message": "NIN IPE Successful",
    "data": {
        "nin": "12345678901",
        "tracking_id": "ABC123XYZ890",
        "extracted_patterns": {
            "registration_center": "Lagos HQ",
            "registration_date": "2015-08-21",
            "fingerprint_status": "Complete",
            "signature_status": "Captured"
        },
        "verification_history": [
            {
                "date": "2023-01-15T10:00:00Z",
                "purpose": "Bank Account Opening"
            }
        ]
    }
}