National ID (without Photo)
Last updated
Was this helpful?
Last updated
Was this helpful?
country
ZA
id_type
NATIONAL_ID_NO_PHOTO
id_number
National identity number
Country
YES
IDType
YES
IDNumber
YES
IssuanceDate
NO
ExpirationDate
N/A
FullName
YES
DOB
YES
Photo
NO
PhoneNumber
NO
PhoneNumber2
NO
Document
NO
Gender
YES
Address
NO
All fields are returned as string
Beyond the standard top-level keys listed in the table above, additional metadata as Date Issued citizenship, age can be found in the FullData Object of the response share. Deceased Status is not returned. Click here to see a sample of the JSON response
To limit the probability of your user mistyping the id number, we advice that you enforce the format of the id number field in your app. You can use the regex below:
/^[0-9]{13}$/
The South Africa national id (without photo) can be used on any of the following products:
For the supported integration options, you can check the integration options supported by each product here.
To test the South Africa national id (without photo) in our Sandbox, we provide you with 5 different id numbers to mirror various scenarios you can experience with real IDs in production.
0000000000000
Success with PII return
1012
0000000000001
Failure, no record found
1013
0000000000002
Invalid ID number format
1014
0000000000003
Database unavailable/unknown network issue
1015
0000000000004*
Success with custom PII return
1012
* You can read more about customising the PII response in sandbox in our documentation here.