Skip to main content

Library South African ID number validation and easy data extraction.

Project description


Library to validate/check and retrieve ID number info for South African IDs

Current version: 0.0.3

Poetry & pip compatibility

Python 3.5 or greater for f-strings



pip install za-id-number


poetry add za-id-number

ZA Id Numbers:

ZA id numbers are based on a luhn algorithm validation, with the last number validating that the entire number is correct.

ZA ID number is broken up into 2 digits birth year, 2 digits birth month, 2 digits birth date, 4 digits for gender, 1 digit for citizenship (za/other), 1 digit race (phased out after 1980) 1 digit for validation.

For more info:

Easiest ZA ID validation is the length. The length must be exactly 13 integers.


from za_id_number.za_identity_number import SouthAfricanIdentityValidate

if __name__ == "__main__":
    za_validation = SouthAfricanIdentityValidate("9202204720082")
    valid = za_validation.validate()
    za_identity = za_validation.identity()
    print(f"Valid: {valid}, Identity: {za_identity}")



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for za-id-number, version 0.0.3
Filename, size File type Python version Upload date Hashes
Filename, size za_id_number-0.0.3-py3.8.egg (4.8 kB) File type Egg Python version 3.8 Upload date Hashes View
Filename, size za_id_number-0.0.3-py3-none-any.whl (3.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size za-id-number-0.0.3.tar.gz (3.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page