South Africa NID Lookup
Overview
South Africa’s national ID system that verifies citizen data against the official population registry. A tamper-resistant smart ID card is issued at age 16, and is compulsory for citizens and permanent residents; it serves as the primary identification document for government and private-sector transactions.
- ID:
south-africa-nid-lookup-2 - Type: eID (database)
- Verification Type: Enrichment
- Regions: Africa
- Countries: ZA
- Adoption: 60,000,000
- URL: https://www.dha.gov.za/
Integration with Trinsic
South Africa NID verification is integrated into Trinsic's identity acceptance network allowing businesses to verify users against the government system of record in South Africa.
- Permission required: Yes, this method requires registration before you can activate it for your users. Please contact Trinsic to begin this process.
- Cost: Contact the Trinsic team.
User Flows
User provides their National ID number. The system retrieves and returns full identity information from the government database.
Direct Mode Bypass
In direct mode, customers can bypass form-fill steps by passing known identity data about the user when launching the integration.
How to Test
Make sure you are working within your "Test" environment. Then follow the steps for your method below:
-
Add
south-africa-nid-lookup-2to a verification profile in your "Test" environment. -
Enter the following credentials:
- National ID:
0000000000000
- National ID:
Direct API Requirements
Direct API is not a requirement.You can integrate with this provider using the Hosted UI instead, with no additional integration requirements on your end.
What your integration must support in order to use this provider with the Direct Provider Sessions API.
- Supports Direct Provider Sessions: ✅
- Launch Method:
None— No user-facing action is required to start the flow. - Collection Method:
PollResult— Results arrive asynchronously; poll with theresultsAccessKeyreturned at session creation. - Requires Input: This provider requires input before verification can proceed.
- Trinsic-Hosted UI: A Trinsic-Hosted Fallback UI exists for this provider, which may be invoked to cover gaps in your integration's capabilities.
Outputs
Normalized AttributesThese attributes form part of our normalized model, a standardized set used across providers. Trinsic normalizes this for you and lets you know when a property is available for each provider.
| Field | Availability | Notes |
|---|---|---|
person.givenName | Always | - |
person.familyName | Always | - |
person.fullName | Always | - |
person.dateOfBirth | Always | - |
person.nationality | Sometimes | When a citizen of South Africa, otherwise null |
person.sex | Always | - |
document.type | Always | - |
document.number | Always | - |
document.issuingCountry | Always | - |
attachments.documentPortrait | Sometimes | Available 99% of the time, but can be missing in authority database |
| Field | Optional | Description | Example Values |
|---|---|---|---|
nationalIdNumber | Yes | The South African National Identity Number (13 digits). Issued for life by the Department of Home Affairs (DHA) and stored in the HANIS (Home Affairs National Identification System) database. The same number is mandatory for banking, employment, taxation, and voting, and is printed on both the legacy green ID book and the Smart ID Card (rolled out from 2013 onward). Format: - YYMMDD G(4) C A Z - YYMMDD is the date of birth - G(4) is the gender code (below 5000 female, 5000 or above male) - C is the citizenship indicator (0 citizen, 1 permanent resident) - A is reserved (it had a politically sensitive meaning in the past, but is currently semantically meaningless) - Z is a Luhn check digit | 9001315000082 |
citizenshipStatus | Yes | Citizenship status of the individual. Possible values: - Citizen - PermanentResident - Refugee | Citizen |
firstName | Yes | First name of the individual. | THABO |
familyName | Yes | Family name of the individual. | MOKOENA |
fullName | Yes | Full name of the individual. | THABO MOKOENA |
sex | Yes | Sex of the individual. Possible values: - Male - Female | Male |
dateOfBirth | Yes | Date of birth of the individual. | 1990-01-31 |
nationality | Yes | Nationality of the individual as an ISO 3166-1 alpha-2 country code. Set to ZA when CitizenshipStatus is Citizen. Null when not a South African citizen (Permanent Resident or Refugee). | ZA |
dateOfDeath | Yes | Date of death of the individual, if recorded by DHA (Department of Home Affairs). Null if the individual is alive, or the data is missing from the registry. | 2024-03-12 |
birthCountry | Yes | Country of birth of the individual as an ISO 3166-1 alpha-2 country code. | ZA |
Updated 11 days ago
