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"
}
}