Lookup NIN

This endpoint allows developers to fetch customers details using the National Identification Number (NIN) of the customer

Request

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

Headers

Parameter	Type	Description
AppId	string	you would need to create an app to get your app ID
Authorization	string	public secret key e.g prod_sk_1T1eSavlZxy02OT3OWlvbxK4G

Query Parameters

Parameter	Type	Description
nin *	string	A valid nin	required

Response Sample

{
    "entity": {
        "nin": "70123456789",
        "firstname": "John",
        "middlename": "Doe",
        "surname": "Alamutu",
        "telephoneno": "08012345678",
        "birthdate": "01-01-1982",
        "photo": "/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgc...",
        "gender": "m",
    }
}

{
    "error": "id not found"
}

Test Credentials for Sandbox

Sample = 70123456789