NIN

This endpoint allows you to look up a virtual national identification number

Our endpoint provides a seamless and secure way for businesses to verify their national ID number, ensuring their sensitive information is kept confidential.

This endpoint utilizes advanced technology to quickly verify your customers’ identity, granting you access to a range of exclusive benefits and services. With just a few clicks, you can verify your customers’ identity and guarantee a seamless experience. Please note that your customers must use their NIN number

👍
TEST DATA
number: 12345678901
OR
number_nin: 12345678901

📘
POST
https://api.prembly.com/verification/vnin

Request Header

Key	Description
x-api-key	Your Secret Key

Request Body

Key	Description
number_nin	NIN

Sample Response

{ 

  "status": true, 

  "response_code": "00", 

  "message": "National Identity Number (NIN) verification successful", 

  "detail": "National Identity Number (NIN) verification successful", 

  "data": { 

    "birthcountry": "nigeria", 

    "birthdate": "22-05-1998", 

    "birthlga": "", 

    "birthstate": "", 

    "centralID": "", 

    "educationallevel": "", 

    "email": "", 

    "employmentstatus": "", 

    "firstname": "CHIDERA", 

    "gender": "f", 

    "heigth": "", 

    "maritalstatus": "", 

    "middlename": "ANITA", 

     "nin": "12345678901", 
 
    "nin_suspension_message": "NOT SUSPENDED",

    "nok_address1": "21 AJANAKU STREET", 

    "nok_address2": "", 

    "nok_firstname": "JOHNATHAN", 

    "nok_lga": "Shomolu", 

    "nok_middlename": "", 

    "nok_postalcode": "", 

    "nok_state": "", 

    "nok_surname": "", 

    "nok_town": "BARIGA", 

    "ospokenlang": "", 

    "pfirstname": "", 

    "photo": "",
      
    "pmiddlename": "", 

    "profession": "", 

    "psurname": "", 

    "religion": "", 

    "residence_address": "21 AJANAKU STREET", 

    "residence_lga": "", 

    "residence_state": "Lagos", 

    "residence_town": "BARIGA", 

    "residencestatus": "", 

    "self_origin_lga": "", 

    "self_origin_place": "", 

    "self_origin_state": "", 

    "signature": "",

    "spoken_language": "", 

    "surname": "JOHNSON", 

    "telephoneno": "08092097506", 
 
    "nin_suspension_status": false,

    "title": "", 

    "trackingId": "", 

    "userid": "", 

    "vnin": "" 

  }, 

  "meta": {}, 

  "billing_info": { 

    "was_charged": true, 

    "amount": "100.00", 

    "currency": "NGN", 

    "reference_id": "V BX-NIN-1ZNS8LS60I", 

    "transaction_id": "a652fe9d-fbe2-4bdc-b0cc-39c80bacd3ad" 

  }, 

  "verification": { 

    "status": "VERIFIED", 

    "reference": "6701f915-1ac8-415b-a828-bc5eb397e75f ", 

    "verification_id": " fa3c598b-5e20-4d6e-861a-0ec3a38a9b2" 

  }, 

  "nin_data": { 

    "birthcountry": "nigeria", 

    "birthdate": "22-05-1998", 

    "birthlga": "", 

    "birthstate": "", 

    "centralID": "", 

    "educationallevel": "", 

    "email": "", 

    "employmentstatus": "", 

    "firstname": "CHIDERA", 

    "gender": "f", 

    "heigth": "", 

    "maritalstatus": "", 

    "middlename": "ANITA", 

    "nin": "12345678901", 

    "nin_suspension_message": "NOT SUSPENDED",

    "nok_address1": "21 AJANAKU STREET", 

    "nok_address2": "", 

    "nok_firstname": "JONATHAN", 

    "nok_lga": "Shomolu", 

    "nok_middlename": "", 

    "nok_postalcode": "", 

    "nok_state": "", 

    "nok_surname": "", 

    "nok_town": "BARIGA", 

    "ospokenlang": "", 

    "pfirstname": "", 

    "photo": "",
      
    "pmiddlename": "", 

    "profession": "", 

    "psurname": "", 

    "religion": "", 

    "residence_address": "21 AJANAKU STREET", 

    "residence_lga": "", 

    "residence_state": "Lagos", 

    "residence_town": "BARIGA", 

    "residencestatus": "", 

    "self_origin_lga": "", 

    "self_origin_place": "", 

    "self_origin_state": "", 

    "signature": "",

    "spoken_language": "", 

    "surname": "JOHNSON", 

    "telephoneno": "08093098607",
 
    "nin_suspension_status": false,

    "title": "", 

    "trackingId": "", 

    "userid": "", 

    "vnin": "" 

  } 

}

Response Description

Response	Description
status	Indicates that the request was successful.
detail	Indicates the detail of the response.
response_code	The first name of the individual.
Nin_data	Contains information related to the National Identification Number (NIN) data of an individual.
firstname	The first name of the individual.
surname	The surname or last name of the individual.
middlename	The middle name of the individual.
birthdate	The date of birth of the individual (in the format DD-MM-YYYY).
userid	The user ID associated with the individual.
gender	The gender of the individual.
telephoneno	The telephone number of the individual.
vnin	The verification national identification number of the individual.
self_origin_lga	The local government area of the individual's place of origin.
heigth	The height of the individual.
birthstate	The state of birth of the individual.
signature	The signature of the individual is not provided.
religion	The religious affiliation of the individual.
educationallevel	The educational level or qualification of the individual.
maritalstatus	The marital status of the individual.
self_origin_state	The state of origin of the individual.
spoken_language	The spoken language or languages of the individual.
trackingId	The tracking ID associated with the individual.
self_origin_place	The place of origin (city/town) of the individual.
residence_town	The town of residence of the individual.
nok_town	The town of residence of the individual's next of kin.
residence_state	The state of residence of the individual.
residence_address	The residential address of the individual.
birthcountry	The country of birth of the individual.
psurname	The surname or last name of the individual's parent.
pfirstname	The first name of the individual's parent.
nok_lga	The local government area of the individual's next of kin.
nok_address2	The address line 2 of the individual's next of kin.
nok_state	The state of residence of the individual's next of kin.
nok_surname	The surname or last name of the individual's next of kin.
nok_firstname	The first name of the individual's next of kin.
ospokenlang	The spoken language or languages of the individual's next of kin.
residencestatus	The residency status of the individual.
pmiddlename	The middle name of the individual's parent.
email	The email address of the individual.
nok_postalcode	The postal code of the individual's next of kin.
nin	The national identification number of the individual.
employmentstatus	The employment status of the individual.
birthlga	The local government area of the individual's birthplace.
base64Image	The person's image encoded in base64 format.
verification	Provides details about the verification process itself.
status	Indicates the status of the verification.
reference	A unique reference or identifier associated with the verification process. It can be used for tracking or reference purposes.

NIN

👍
TEST DATA

📘
POST

Sample Response

Response Description

👍TEST DATA

📘POST

Sample Response

Response Description

👍
TEST DATA

📘
POST