Skip to main content
POST
/
api
/
onboarding
/
nigeria_kyc
/
nin
NIN Verification
curl --request POST \
  --url https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/ \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "nin": "12345678901"
}
'
{
  "status": "failed",
  "data": [
    "<unknown>"
  ],
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.smartcomply.com/llms.txt

Use this file to discover all available pages before exploring further.

The NIN endpoint retrieves a customer’s verified identity data from the National Identity Management Commission (NIMC) database. It returns comprehensive personal details including biographic data, next-of-kin information, and a customer photo.

​
Endpoint

POST /api/onboarding/nigeria_kyc/nin/

​
Request

​
Headers

HeaderValueRequired
x-access-tokenYour API secret keyYes
Content-Typeapplication/jsonYes

​
Body Parameters

ParameterTypeRequiredDescription
identification_numberstringYesThe customer’s 11-digit National Identification Number

​
Example

curl -X POST "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/" \
  -H "x-access-token: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"identification_number": "70123456789"}'

​
Response

​
200 OK

FieldTypeDescription
data.ninstringThe NIN that was queried
data.firstNamestringFirst name
data.middleNamestringMiddle name
data.lastNamestringSurname
data.genderstring"male" or "female"
data.dateOfBirthstringDate of birth in YYYY-MM-DD format
data.birthStatestringState of birth
data.birthLgastringLGA of birth
data.telephoneNostringRegistered phone number
data.emailstring | nullEmail address (if available)
data.residenceAddressstringCurrent residential address
data.residenceStatestringState of residence
data.residenceLgastringLGA of residence
data.residenceTownstringTown of residence
data.maritalStatusstringe.g., "single", "married", "separated"
data.educationalLevelstringHighest education level
data.employmentStatusstringe.g., "employed", "unemployed"
data.religionstringReligion
data.spokenLanguagestringPrimary spoken language
data.heightstringHeight in centimetres
data.professionstringStated profession
data.nokFirstnamestringNext-of-kin first name
data.nokSurnamestringNext-of-kin surname
data.nokAddress1stringNext-of-kin address
data.nokStatestringNext-of-kin state
data.nokLgastringNext-of-kin LGA
data.imagestringBase64-encoded JPEG of the customer’s photo
data.trackingIdstringNIMC tracking reference
{
  "status": "success",
  "data": {
    "title": "mr",
    "lastName": "DOE",
    "firstName": "JOHN",
    "middleName": "JOSEPH",
    "gender": "male",
    "dateOfBirth": "2000-10-21",
    "birthLga": "Olamaboro",
    "birthState": "Kogi",
    "centralID": "",
    "educationalLevel": "secondary",
    "email": null,
    "nin": "12345678901",
    "employmentStatus": "unemployed",
    "height": "180",
    "maritalStatus": "separated",
    "religion": "christianity",
    "telephoneNo": "08050003000",
    "residenceAddress": "MR SNUFUSS'S HOUSE SNUFUSS STREET PHASE 3",
    "residenceLga": "Gwagwalada",
    "residenceState": "FCT Abuja",
    "residenceTown": "GWAGWALADA",
    "nokFirstname": "JOHN",
    "nokSurname": "DOE",
    "nokAddress1": "NO 6 ADUM ROAD OGUGU CENTRE",
    "nokState": "Kogi",
    "nokLga": "Olamaboro",
    "profession": "STUDENT",
    "spokenLanguage": "IGALA",
    "trackingId": "S2R0NYFO01113TR",
    "image": "<base64-encoded-jpeg>"
  },
  "message": "National Identification Number details retrieved successfully"
}

​
400 Bad Request

Returned when the NIN is missing, malformed, or not found. 
{
  "status": "failed",
  "data": [],
  "message": "Sorry, your check cannot be processed at the moment. Please try again in a few minutes"
}

​
401 Unauthorized

{
  "status": "failed",
  "message": "Authentication credentials were not provided."
}

Authorizations

​
x-access-token
string
header
required

Your Adhere API secret key

Body

application/json
​
nin
string
required

11-digit National Identification Number

Example:

"12345678901"

Response

NIN verified successfully