NIN Modification API

Submit requests to modify specific demographic details linked to a National Identity Number (NIN), such as name correction, date of birth, phone number, gender, residence address, or state of origin. Track processing status in real time.

Service Online / Available

POST /api/v1/nin/modification

Authentication & Headers

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

Authorized Field Codes & Realtime Pricing

Role: Default

FIELD CODE	SERVICE NAME	DESCRIPTION	PRICE (₦)	STATUS
`032`	Correction of name	correction of name on the nin	₦8,000.00	Available
`033`	Phone Number Update	correction of phone number on nin	₦8,000.00	Available
`034`	Gender Update	Gender update on nin	₦30,000.00	Available
`035`	Date of birth update below 5 year	Correction of date of birth below...	₦60,000.00	Available
`036`	Date of birth Update above 5 year	correction of date of birth on...	₦150,000.00	Available
`037`	Change of Ressidence Address	change of residence address on the...	₦8,000.00	Available
`0141`	Change of state of Origin	Modification service for Change of state...	₦35,000.00	Available
`NIN100`	Marriage Status Update	Update Marriage status on NIN	₦20,000.00	Available
`NIN1001`	Change of Origin Address	Change of origin address	₦20,000.00	Available

Request Parameters (POST)

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`field_code`	string	Authorized active modification field code (e.g. `032`).	Required
`nin`	string	The 11-digit National Identity Number being modified.	Required
`description`	string	Summary or specific explanation of the modification request.	Optional
`modification_data`	object	Structured payload containing updated fields (e.g. `{"first_name": "Ibrahim", "surname": "Musa"}`).	Optional

Example Submit Request

cURL (POST)

curl -X POST "https://www.api.arewasmart.com.ng/api/v1/nin/modification" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "field_code": "032",
    "nin": "12345678901",
    "description": "Correction of name on NIN",
    "modification_data": {
      "first_name": "Ibrahim",
      "surname": "Musa"
    }
  }'

Success Response (200 OK)

200 OK

{
  "status": "success",
  "code": 200,
  "message": "Request submitted, pending processing",
  "data": {
    "reference": "MOD4559R2DYP",
    "status": "pending",
    "nin": "12345678901",
    "service": "Correction of name",
    "comment": "Your request is processing, it will be treated in 24 to 72h"
  }
}

Failed Response (400 Bad Request)

400 Bad Request

{
  "status": "failed",
  "code": 400,
  "message": "The selected field code is not authorized for NIN Modification requests."
}

Check Modification Status

GET /api/v1/nin/modification?nin=12345678901

Query Parameters (GET)

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`nin`	string	The 11-digit National Identity Number submitted with the modification.	Optional*
`reference`	string	The transaction reference returned upon submission (e.g. `MOD4559R2DYP`).	Optional*

* Note: You must provide at least one query parameter (either nin or reference) to retrieve the status.

Example Status Check Request

cURL (GET)

# Query by NIN:
curl -X GET "https://www.api.arewasmart.com.ng/api/v1/nin/modification?nin=12345678901" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

# Alternatively query by Reference:
curl -X GET "https://www.api.arewasmart.com.ng/api/v1/nin/modification?reference=MOD4559R2DYP" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Status Check Response (200 OK)

200 OK

// When completed:
{
  "status": "success",
  "code": 200,
  "message": "Status checked.",
  "data": {
    "reference": "MOD4559R2DYP",
    "nin": "12345678901",
    "service": "Correction of name",
    "status": "completed",
    "comment": "NIN modification completed successfully. Updated record synchronized with NIMC registry."
  }
}

// When pending:
{
  "status": "success",
  "code": 200,
  "message": "Status checked.",
  "data": {
    "reference": "MOD4559R2DYP",
    "nin": "12345678901",
    "service": "Correction of name",
    "status": "pending",
    "comment": "Your request is processing, it will be treated in 24 to 72h"
  }
}