NIN Lookup
This page contains information about how to integrate the NIN verification services into your application.
To carry out a National Identification Number (NIN) lookup, choose any of the channels below that align with your sector or industry to submit your verification request.
API Endpoints
BASE_API: https://api.truztcube.com/v1/
IMPORTANT: This verification system is exclusively for use by government agencies and financial institutions, as mandated by the regulator.
Request Headers
x-api-key*
string
Your organization's secret API key for authentication is available on your Truztcube dashboard.
method*
string
POST
Request Body
All the params listed below are required.
nin
string
unique 11 digits issued by the NIMC to the ID holder
request_reason
enum
Reason for the verification check: Please review the linked document for the list of reasons and select the one that applies to your use case. see the link below for approved reasons.
enterprise_id
string
Unique code provided to an authorized enterprise
Sample CURL Request
Substitute the values with test/live information gotten from your Truztcube dashboard
curl --location 'https://api.truztcube.com/v1/nin/raw/lookup'
--header 'x-api-key: TEST_aeXdR8Inarssmzm6M8CokJbTh6nAemES' \
--header 'method: POST'\
--data '{
"nin":"12345678901",
"request_reason": "nyscCheck",
"enterprise_id": "ENT4SANDBOX"
}' Successful CURL Response
{
"status": 200,
"success": true,
"message": "successfully fetched user data",
"data": {
"biographicData": {
"birthCountry": "nigeria",
"birthLga": "Utopia",
"birthState": "Bendel",
"dateOfBirth": "01-01-1900",
"educationLevel": "tertiary",
"employmentStatus": "unemployed",
"firstName": "JOHN",
"gender": "m",
"height": "169",
"lastName": "DOE",
"maritalStatus": "single",
"middleName": "Mary",
"nativeSpokenLanguage": "English",
"nextOfKinAddressLine1": "NO. 22 Aso Villa",
"nextOfKinFirstName": "Mary",
"nextOfKinLga": "Utopia",
"nextOfKinMiddleName": "Doe",
"nextOfKinSurname": "Jane",
"nextOfKinTown": "Kano",
"originLga": "Arochukwu",
"originPlace": "OKPOGA",
"originState": "LAGOS",
"profession": "STUDENT",
"religion": "christianity",
"residenceAddressLine1": "NO. 22 ASO Villa",
"residenceLga": "Abuja",
"residenceState": "Benue",
"residenceStatus": "birth",
"residenceTown": "Barkin Chiawa",
"title": "Mr"
},
"biometricData": [
{
"biometricSubType": "face",
"biometricType": "photo",
"image":"/sm71.."
},
{
"biometricSubType": "signature",
"biometricType": "signature",
"image": "/9j/4AAQSkZ.."
}
],
"contactData": {
"phone1": "08030000000"
}
}
}
Error Format
{
"statusCode": 500,
"message": "Request failed: Request failed with status code 500"
}
Verification Reasons
The array below lists the values needed for request_reason in your verification. Please include the key value with your submission.
"data": [
{
"key": "taxationEnrollment",
"label": "Taxation Enrollment"
},
{
"key": "taxationAssessment",
"label": "Taxation Assessment"
},
{
"key": "taxationEnforcement",
"label": "Taxation Enforcement"
},
{
"key": "corporateAffairsDirector",
"label": "Corporate Affairs Director"
},
{
"key": "corporateAffairsShareholder",
"label": "Corporate Affairs Shareholder"
},
{
"key": "corporateAffairsTrustee",
"label": "Corporate Affair Trustee"
},
{
"key": "medical",
"label": "Medical"
},
{
"key": "educationExam",
"label": "Education Exam"
},
{
"key": "educationAdmission",
"label": "Education Admission"
},
{
"key": "educationPromotion",
"label": "Education Promotion"
},
{
"key": "employmentRecruitment",
"label": "Employment Recruitment"
},
{
"key": "employmentEnrollment",
"label": "Employment Enrollment"
},
{
"key": "employmentDismissal",
"label": "Employment Dismissal"
},
{
"key": "creditBackgroundCheck",
"label": "Credit Background Check"
},
{
"key": "financialProducts",
"label": "Financial Products"
},
{
"key": "insurance",
"label": "Insurance"
},
{
"key": "clearanceForPoliticalOffice",
"label": "Clearance For Policitive Office"
},
{
"key": "legalCourts",
"label": "Legal Courts"
},
{
"key": "legalEnrollment",
"label": "Legal Enrollment"
},
{
"key": "crimePrisonIncarceration",
"label": "Crime Prison Incarceration"
},
{
"key": "passportImmigration",
"label": "Passport Immigration"
},
{
"key": "pensionEnrollment",
"label": "Pension Enrollment"
},
{
"key": "socioCulturalEnrollment",
"label": "Socio-cultural Enrollment"
},
{
"key": "entertainment",
"label": "Entertainment"
},
{
"key": "physicalAccess",
"label": "Physical Access"
},
{
"key": "logicalVirtualAccess",
"label": "Logical Virtual Access"
},
{
"key": "telecommunicationSimReg",
"label": "Telecommunication Sim Registration"
},
{
"key": "telecommunicationIotReg",
"label": "Telecommunication Iot Registration"
},
{
"key": "aviationTransport",
"label": "Aviation Transport"
},
{
"key": "roadTransport",
"label": "Road Transport"
},
{
"key": "maritimeTransport",
"label": "Maritime Transport"
},
{
"key": "railwayTransport",
"label": "Railway Transport"
},
{
"key": "leaCheck",
"label": "Lea Check"
},
{
"key": "defence",
"label": "Defence"
},
{
"key": "nyscCheck",
"label": "NYSC Check"
},
{
"key": "efccCheck",
"label": "EFCC Check"
},
{
"key": "blacklistPolitical",
"label": "Blacklist Political"
},
{
"key": "blacklistSocial",
"label": "Blacklist Social"
}
]
}Last updated