Lookup SA NIN
Lookup South Africa 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",
"maidenname": "",
"telephoneno": "08012345678",
"state": "Ekiti",
"place": "ADO ",
"profession": "STUDENT",
"title": "mr",
"height": "****",
"email": "",
"birthdate": "01-01-1982",
"birthstate": "Ekiti",
"birthcountry": "nigeria",
"centralID": "5227123",
"documentno": "",
"educationallevel": "tertiary",
"employmentstatus": "",
"nok_firstname": "John 2",
"nok_lastname": "Doe 2",
"nok_middlename": "",
"nok_address1": "Address of NOK",
"nok_address2": "",
"nok_lga": "Garki",
"nok_state": "Abuja",
"nok_town": "Garki",
"nok_postalcode": "",
"othername": "",
"pfirstname": "",
"photo": "/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgc...",
"pmiddlename": "",
"psurname": "",
"nspokenlang": "YORUBA",
"ospokenlang": "ENGLISH",
"religion": "christianity",
"residence_Town": "IKOTUN EGBE",
"residence_lga": "Alimosho",
"residence_state": "Lagos",
"residencestatus": "birth",
"residence_AddressLine1": null,
"residence_AddressLine2": "26 Billion STREET AGODO AREA",
"self_origin_lga": "Alimosho",
"self_origin_place": "",
"self_origin_state": "Lagos",
"signature": "/9j/4AAQSkZJRgABAQEAlgCWAAD/2wBDAAgGBgcGBQgHBwcJCQ...",
"nationality": "",
"gender": "m",
"trackingId": "S7Y0NYFD12347WS"
}
}
Updated over 2 years ago