Lookup NIN

Request

[GET]
{{baseURL}}/api/v1/kyc/nin
HeaderTypeDescription
AppIdstringCreate an app to get your app ID on dashboard here
Authorizationstringpublic secret key

Query parameters

ParameterTypeDescriptionRequired
nin *stringA valid ninrequired

Sample response

[200]

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

Lookup NIN Advance

Request

[GET]
{{baseURL}}/api/v1/kyc/nin/advance

Query parameters

ParameterTypeDescriptionRequired
nin *stringA valid ninrequired

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",
        "email": "",
        "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": ""
    }
}

Test Credentials for Sandbox

Kindly use this Test NIN in sandbox Environment nin = 70123456789