NIN Personalisation API

Retrieve National Identification Numbers (NIN) and demographic data using an Enrolment Tracking ID. Track processing status in real time.

Service Online / Available

POST /api/v1/nin/personalisation

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
`005`	NIN Personalisation	Retrieve National Identification Number (NIN)...	₦250.00	Available

Request Parameters (POST)

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`field_code`	string	Authorized active field code (e.g. `005`).	Required
`tracking_id`	string	The NIMC Enrolment Tracking ID (e.g. `WN0123456789ABC`).	Required
`description`	string	Custom note or description for this request.	Optional

Example Submit Request

cURL (POST)

curl -X POST "https://www.api.arewasmart.com.ng/api/v1/nin/personalisation" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "field_code": "005",
    "tracking_id": "WN0987654321XYZ",
    "description": "NIN Personalisation Request"
  }'

Success Response (200 OK)

200 OK

{
  "status": "success",
  "code": 200,
  "message": "Request submitted, pending processing",
  "data": {
    "reference": "PERS4559R2DYP",
    "status": "pending",
    "tracking_id": "WN0987654321XYZ",
    "service": "NIN Personalisation",
    "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 Personalisation."
}

Check Personalisation Status

GET /api/v1/nin/personalisation?tracking_id=WN0987654321XYZ

Query Parameters (GET)

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`tracking_id`	string	The NIMC Enrolment Tracking ID submitted with the request.	Optional*
`reference`	string	The transaction reference returned upon submission (e.g. `PERS4559R2DYP`).	Optional*

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

Example Status Check Request

cURL (GET)

# Query by Tracking ID:
curl -X GET "https://www.api.arewasmart.com.ng/api/v1/nin/personalisation?tracking_id=WN0987654321XYZ" \
  -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/personalisation?reference=PERS4559R2DYP" \
  -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": "PERS4559R2DYP",
    "tracking_id": "WN0987654321XYZ",
    "nin": "71073866272",
    "service": "NIN Personalisation",
    "status": "completed",
    "comment": "Personalisation record resolved successfully.",
    "file_url": "https://storage.arewasmart.com/slips/WN0987654321XYZ.pdf",
    "nin_slip_url": "https://storage.arewasmart.com/slips/WN0987654321XYZ.pdf",
    "submission_date": "2026-09-26 12:35:00"
  }
}

// When pending:
{
  "status": "success",
  "code": 200,
  "message": "Status checked.",
  "data": {
    "reference": "PERS4559R2DYP",
    "tracking_id": "WN0987654321XYZ",
    "nin": null,
    "service": "NIN Personalisation",
    "status": "pending",
    "comment": "Your request is processing, it will be treated in 24 to 72h"
  }
}