NIN Validation API

Submit requests to validate and resolve National Identification Numbers (NIN) with registry issues such as No Record Found, Photographic Errors, NIN Suspension, or SIM Registration errors. Track processing status in real time.

Service Online / Available

POST /api/v1/nin/validation

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
`015`	No record fund	NIN validation on response no record...	₦1,000.00	Available
`016`	Photographic Error	Validate NIN with photographic response	₦1,000.00	Available
`017`	NIN Suspension	Validation of suspended nin know that...	₦2,500.00	Available
`018`	Record update	Validation on NIN record update	₦1,000.00	Available
`019`	Modifcation Validation	Validate NIN to reflect to modification	₦1,200.00	Available
`020`	Sim Registration validation	NIN migration from child enrolment to...	₦1,000.00	Available
`0140`	Modification validation	validate nin to effect pending modification	₦1,200.00	Available
`0142`	NIN Revalidation	Validation service for NIN Revalidation	₦1,500.00	Available

Request Parameters (POST)

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`field_code`	string	Authorized active validation field code (e.g. `015`).	Required
`nin`	string	The 11-digit National Identity Number to validate.	Required
`description`	string	Optional custom reference, customer note, or internal order identifier (max: 255 chars).	Optional

Example Submit Request

cURL (POST)

curl -X POST "https://www.api.arewasmart.com.ng/api/v1/nin/validation" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "field_code": "015",
    "nin": "12345678901",
    "description": "Validation for customer no record"
  }'

Success Response (200 OK)

200 OK

{
  "status": "success",
  "code": 200,
  "message": "Request submitted, pending processing",
  "data": {
    "reference": "val4559R2DYP",
    "status": "pending",
    "nin": "12345678901",
    "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 Validation requests."
}

Check Validation Status

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

Query Parameters (GET)

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`nin`	string	The 11-digit National Identity Number submitted with the request.	Optional*
`reference`	string	The transaction reference returned upon submission (e.g. `val4559R2DYP`).	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/validation?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/validation?reference=val4559R2DYP" \
  -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": "val4559R2DYP",
    "nin": "12345678901",
    "status": "completed",
    "comment": "NIN validation completed successfully. Record has been updated on NIMC database."
  }
}

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