JSON Top-Level Keys

An easy way to interact with our API
Due to discrepancies of keys returned from our providers, we have filtered and standardized the JSON top-level keys below to simplify the use of our JSON response across all our supported ID types.
 Sample JSON Response
​
},
    "Country": "NG",
    "IDType": "NIN",
    "IDNumber": "00000000000",
    "ExpirationDate": "Not Available",
    "FullName": "Doe Joe Leo",
    "DOB": "2000-01-20",
    "Photo": "/9j/4AAQSkZJRgABAgAAAQABAAD/
    "PhoneNumber": "12345678900",
    "Gender": "Male",
    "Address": "10, Workbox, Ojora Close, Victoria Island, Lagos State",
    "IDNumberPreviouslyRegistered": <true | false>,
    "UserIDsOfPreviousRegistrants": ["12134", "23456"],
    . 
    .
  "FullData": {
        "nin": "00000000000",
        "firstname": "Doe",
        "middlename": "Joe",
        "surname": "Leo",
        "maidenname": "",
        "telephoneno": "12345678900",
        "state": "Lagos",
        "place": "IBEJU",
        "title": "mr",
        "height": "****",
        "email": "",
        "birthdate": "20-01-2000",
        "birthstate": "Lagos",
        "birthcountry": "nigeria",
        "centralID": "0000000",
        "documentno": "",
        "educationallevel": "tertiary",
        "employmentstatus": "",
        "maritalstatus": "single",
        "nok_lastname": "Doe",
        "othername": "",
        "pfirstname": "",
        "photo": "/9j/4AAQSkZJRgABAgAAAQABAAD/",
        "pmiddlename": "",
        "psurname": "",
        "profession": "SOME PROFESSION",
        "nspokenlang": "YORUBA",
        "ospokenlang": "ENGLISH",
        "residence_town": "VICTORIA ISLAND",
        "residence_lga": "ETI-OSA",
        "residence_state": "Lagos",
        "residencestatus": "birth",
        "residence_AddressLine1": "",
        "residence_AddressLine2": "",
        "self_origin_lga": "Eti-Osa",
        "self_origin_place": "IBEJU",
        "self_origin_state": "Lagos",
        "nationality": "",
        "gender": "m",
        "trackingId": "X0X0XXXXX00000X",
        "success": true,
        "message": "Results Found"
}
Informational Keys
Growth in user base is accompanied by challenges, one of such is the threat of rogue or fraudulent sign ups. One such threat is multiple signups with the same ID number. To find out more about this issue and our suggested best practices, you can read here in our docs.

To help you manage this issue, Smile ID added two Top Level Keys in our response JSON in order to track previously used regulatory ID numbers.

"IDNumberPreviouslyRegistered" is a boolean which tells you if this ID number has been used before to register one of your users.*
"UserIDsOfPreviousRegistrants" If the ID Number has been previously used for successful registration, an array of the previous user IDs will be returned.*
*This only applies to responses on Job Type 1 - "User Registrations with ID Number”
Data availability
The table below summaries the breakdown of the top-level keys that are consistently returned by our supported ID types (e.g. NIN, SSNIT etc) across all coverage services. This will guide and ensure you interact with the JSON data appropriately.
 Nigeria ID data availability
IDType/Key Returned
IDNumber
Full  Name
DOB
Photo
Gender
Expiration Date
Address
Phone Number
NIN
 ✅ 
 ✅​
​✅ 
 ✅ 
 ✅ 
​
 ✅ 
 ✅​
NIN_SLIP
 ✅ 
​✅ 
 ✅ 
​✅ 
 ✅ 
​
 ✅ 
​✅ 
BVN
​✅ 
 ✅​
 ✅ 
  
 ✅ 
​
  
 ✅​
VOTER’S ID
​✅ 
 ✅ 
​
 ✅ 
 ✅​
​
 ✅ 
 ✅ 
DRIVER’S LICENSE
 ✅ 
 ✅ 
 ✅ 
 ✅​
 ✅​
 ✅ 
​
​
TIN
 ✅ 
 ✅ 
​
​
​
​
​
 ✅ 
CAC
 ✅ 
 ✅ 
​
​
​
​
​
​
Ghana ID data availability
IDType/Key Returned
IDNumber
Full    Name
DOB
Photo
Gender
Expiration       Date
Address
Phone Number
SSNIT
 ✅​
 ✅​
​✅ 
 ✅​
 ✅​
​
​
​
VOTER’S ID
 ✅​
 ✅​
​
 ✅​
 ✅ 
​
​
​
DRIVER’S LICENSE
 ✅​
 ✅​
 ✅ 
 ✅​
​
​✅ 
​
​
PASSPORT
 ✅​
 ✅​
 ✅ 
 ✅​
 ✅​
 ✅​
​
​
Kenya ID data availability
IDType/Key Returned
IDNumber
Full    Name
DOB
Photo
Gender
Expiration Date
Address
Phone Number
NATIONAL ID
 ✅​
​✅ 
​✅ 
​✅ 
​✅ 
​
 ✅​
​
ALIEN CARD
 ✅​
​✅ 
​✅ 
​✅ 
​✅ 
​
 ✅​
​
PASSPORT
 ✅​
​✅ 
​✅ 
​✅ 
 ✅ 
 ✅​
 ✅​
​
South Africa ID data availability
IDType/Key Returned
IDNumber
Full    Name
DOB
Photo
Gender
Expiration Date
Address
Phone Number
NATIONAL
ID
 ✅ 
​✅ 
 ✅ 
 ✅ 
 ✅ 
​
​
​
NATIONAL_ID
NO_PHOTO
 ✅ 
​✅ 
 ✅ 
​
 ✅ 
​
​
​
​
Please note some fields (such as Address, Phone numbers) are the most recent officially on file at the ID Authority and might not be current or active. Update of such fields is at the discretion of the ID Authority and User.
​
Results - Previous
Callbacks
Next - Results
ID Authority Data Responses
Last updated 2 months ago
IDType/Key Returned	IDNumber	Full Name	DOB	Photo	Gender	Expiration Date	Address	Phone Number
NIN	✅	✅	✅	✅	✅		✅	✅
NIN_SLIP	✅	✅	✅	✅	✅		✅	✅
BVN	✅	✅	✅		✅			✅
VOTER’S ID	✅	✅		✅	✅		✅	✅
DRIVER’S LICENSE	✅	✅	✅	✅	✅	✅
TIN	✅	✅						✅
CAC	✅	✅