Complete step-by-step tutorial for integrating South African ID verification into your application
Start with a free test API key for development. No credit card required.
Free test key available! Sign in to view your test API key, or create your own key from the API Keys dashboard.
Get API KeyThe Check ID API offers two validation endpoints to suit your needs:
Perfect for real-time form validation and individual verifications
GET /api/v1/validate/{idNumber}Process up to 100 ID numbers simultaneously - ideal for CSV imports and batch processing
POST /api/v1/validate/bulkChoose your programming language and copy the code examples below:
// Single ID Verification
const verifyID = async (idNumber) => {
const response = await fetch(`https://api.checkid.co.za/api/v1/validate/${idNumber}`, {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});
return await response.json();
};
// Bulk ID Verification (up to 100 IDs)
const verifyBulkIDs = async (idNumbers) => {
const response = await fetch('https://api.checkid.co.za/api/v1/validate/bulk', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({ idNumbers })
});
return await response.json();
};Pro Tip
Use bulk validation for CSV uploads or database imports - process up to 100 IDs in a single request for maximum efficiency.
Here's the exact response structure you'll receive for each ID verification:
{
"idNumber": "8903075555088",
"isValid": true,
"dob": "1989-03-07T00:00:00",
"age": 35,
"gender": "M",
"citizenship": "SA Citizen"
}| Field | Description | Use Case |
|---|---|---|
isValid | Boolean indicating if ID number is valid | Input validation, error handling |
dob | Extracted birth date | Age verification, demographics |
gender | M/F from ID structure | User personalization |
citizenship | SA Citizen/Permanent Resident | Compliance, eligibility checks |
Join 1,000+ South African businesses automating their ID verification process. Get started with 10 free verifications - no credit card required.