NIN Lookup: Verify Identity with National ID

Fetch identity details from NIMC using a Nigerian National Identification Number. Name, DOB, photo, and more in one call.

Lookup NIN

Request

[GET]

{{baseURL}}/api/v1/kyc/nin

Header

Header	Type	Description
AppId	string	Create an app to get your app ID on dashboard here
Authorization	string	Private/secret key. Use <key> not Bearer <key>

Query parameters

Parameter	Type	Description	Required
nin *	string	A valid nin	required

Sample response

[200]

        {
            "entity": {
                "first_name": "John",
                "last_name": "Doe",
                "gender": "Male",
                "middle_name": "",
                "photo": "/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgc...",
                "date_of_birth": "1982-01-01",
                "phone_number": "08012345678",
                "employment_status": "unemployment",
                "marital_status": "Single"
            }
        } 

Response Fields

Field	Type	Description
entity	object	Contains the NIN holder’s identity details
entity.first_name	string	First name of the NIN holder
entity.last_name	string	Last name of the NIN holder
entity.gender	string	Gender of the NIN holder
entity.middle_name	string	Middle name of the NIN holder
entity.photo	string	Base64-encoded photograph of the NIN holder
entity.date_of_birth	string	Date of birth in YYYY-MM-DD format
entity.phone_number	string	Phone number linked to the NIN
entity.employment_status	string	Employment status of the NIN holder
entity.marital_status	string	Marital status of the NIN holder

Lookup NIN Advance

Request

[GET]

{{baseURL}}/api/v1/kyc/nin/advance

Query parameters

Parameter	Type	Description	Required
nin *	string	A valid nin	required

Sample response

[200]

{
    "entity": {
        "nin": "12345678910",
        "first_name": "John",
        "last_name": "Doe",
        "middle_name": "Anon",
        "date_of_birth": "1909-01-11",
        "phone_number": "081123456798",
        "photo": "/9j/4AAQSz\nQBKtKKaOgp460hjlpw4pmcGnA8Uhj6Mc0g6UCg...",
        "gender": "Male",
        "employment_status": "unemployed",
        "marital_status": "single",
        "birth_country": "nigeria",
        "birth_lga": "Ikeja",
        "birth_state": "Lagos",
        "educational_level": "tertiary",
        "maiden_name": "",
        "nspoken_lang": "YORUBA",
        "profession": "STUDENT",
        "religion": "christianity",
        "residence_address_line_1": "2, ANON STREET",
        "residence_address_line_2": "",
        "residence_status": "birth",
        "residence_town": "",
        "residence_lga": "Ikeja West",
        "residence_state": "Ikeja",
        "ospoken_lang": "ENGLISH",
        "origin_lga": "Ikeja",
        "origin_place": "",
        "origin_state": "Lagos",
        "height": "171",
        "p_first_name": "",
        "p_middle_name": "",
        "p_last_name": "",
        "tax_id": "211111111111111111",
        "tax_residency": "Lagos State"
    }
}

Response Fields

Field	Type	Description
entity	object	Contains the NIN holder’s identity details
entity.nin	string	National Identification Number
entity.first_name	string	First name of the NIN holder
entity.last_name	string	Last name of the NIN holder
entity.middle_name	string	Middle name of the NIN holder
entity.date_of_birth	string	Date of birth in YYYY-MM-DD format
entity.phone_number	string	Phone number linked to the NIN
entity.photo	string	Base64-encoded photograph of the NIN holder
entity.gender	string	Gender of the NIN holder
entity.employment_status	string	Employment status of the NIN holder
entity.marital_status	string	Marital status of the NIN holder
entity.birth_country	string	Country of birth
entity.birth_lga	string	Local Government Area of birth
entity.birth_state	string	State of birth
entity.educational_level	string	Highest level of education attained
entity.maiden_name	string	Maiden name, if applicable
entity.nspoken_lang	string	Native spoken language
entity.profession	string	Profession or occupation
entity.religion	string	Religious affiliation
entity.residence_address_line_1	string	Primary residential address line
entity.residence_address_line_2	string	Secondary residential address line
entity.residence_status	string	Residential status (e.g., birth, rental)
entity.residence_town	string	Town of residence
entity.residence_lga	string	Local Government Area of residence
entity.residence_state	string	State of residence
entity.ospoken_lang	string	Other spoken language
entity.origin_lga	string	Local Government Area of origin
entity.origin_place	string	Place of origin
entity.origin_state	string	State of origin
entity.height	string	Height in centimeters
entity.p_first_name	string	Next-of-kin first name
entity.p_middle_name	string	Next-of-kin middle name
entity.p_last_name	string	Next-of-kin last name
entity.tax_id	string	Tax Identification Number
entity.tax_residency	string	State of tax residency

Test Credentials for Sandbox

Kindly use this Test NIN in sandbox Environment

nin = 70123456789