Developer Documentation
IDENTITY VERIFICATION

NIN Modification

Submit requests to modify specific details linked to a National Identity Number, such as changing a name, date of birth, or address.

POST /api/v1/nin-modification
Authentication & Headers
HEADER VALUE REQUIRED
Authorization Bearer YOUR_API_TOKEN Yes
Content-Type multipart/form-data Yes
Multipart Request Required

This endpoint requires multipart/form-data formatting because file uploads (supporting documents) are mandatory for modifcation requests.

Request Parameters

PARAMETER TYPE DESCRIPTION REQUIRED
nin string The 11-digit NIN being modified. Required
tracking_id string Associated tracking ID from the original record. Required
modification_type string e.g., name, dob, address. Required
new_value string The new value representing the modification. Required
supporting_document file PDF or Image (JPEG/PNG) document proof. Required
Success Response
{
    "status": true,
    "message": "NIN Modification Request Submitted Successfully",
    "data": {
        "reference": "MOD-100200300",
        "nin": "12345678901",
        "modification_type": "name",
        "status": "pending_approval",
        "submitted_at": "2024-03-05T16:00:22Z"
    }
}