Reverse NIDA

A Python package that attempts to reverse engineer how NIDA (National Identification Authority) numbers are generated and extract basic information from National Identification Numbers (NIN) without using the official NIDA API.

⚠️ Disclaimer

This project is for educational and research purposes only. It attempts to understand the structure and patterns in NIDA numbers through reverse engineering. The accuracy of extracted information is not guaranteed, and this should not be used for official verification purposes.

🚀 Installation

From PyPI

pip install reverse-nida

📖 Usage

Simple Usage (Recommended)

from r_nida import get_basic_info

# Analyze a NIDA number (supports both dashed and compact formats)
nin_dashed = "xxxxxxxx-xxxxx-xxxxx-xx"
nin_compact = "xxxxxxxxxxxxxxxxxxxx"

# Get basic information
info = get_basic_info(nin_dashed, debug=False)
print(info)
# Output: {
#   'BIRTHDATE': '',
#   'GENDER': '',
#   'REGIONCODE':'',
#   'REGION': '',
#   'DISTRICT': '',
#   'WARDCODE':'',
#   'WARD': '',
#   'WARDCODE': '',
#   'STREET': '',
#   'PLACES':'',
# }

# Get full information with debug
info = service.get_basic_info("xxxxxxxx-xxxxx-xxxxx-xx", debug=True)

Setup Development Environment

git clone https://github.com/Henryle-hd/reverse-nida.git
cd reverse-nida