{"id":15640349,"url":"https://github.com/kalebu/nida","last_synced_at":"2025-07-13T06:33:18.605Z","repository":{"id":44544353,"uuid":"359756359","full_name":"Kalebu/Nida","owner":"Kalebu","description":"Unofficial package for fetching users information based on National ID Number (Tanzania) ","archived":false,"fork":false,"pushed_at":"2023-09-17T11:06:06.000Z","size":2116,"stargazers_count":81,"open_issues_count":3,"forks_count":22,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-12-17T06:17:21.468Z","etag":null,"topics":["national-id-libary","nida-api","nida-api-tanzania","python","python-nida","python-tanzania","tanzania"],"latest_commit_sha":null,"homepage":"https://kalebu.github.io/Nida/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kalebu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"patreon":"kalebujordan"}},"created_at":"2021-04-20T09:22:01.000Z","updated_at":"2024-11-23T23:14:14.000Z","dependencies_parsed_at":"2024-10-23T05:09:26.987Z","dependency_job_id":null,"html_url":"https://github.com/Kalebu/Nida","commit_stats":{"total_commits":12,"total_committers":4,"mean_commits":3.0,"dds":0.25,"last_synced_commit":"44c09dda8caa6afa8d8ac90db378e262351206f2"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kalebu%2FNida","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kalebu%2FNida/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kalebu%2FNida/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kalebu%2FNida/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kalebu","download_url":"https://codeload.github.com/Kalebu/Nida/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230382859,"owners_count":18216854,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["national-id-libary","nida-api","nida-api-tanzania","python","python-nida","python-tanzania","tanzania"],"created_at":"2024-10-03T11:34:39.255Z","updated_at":"2024-12-19T05:08:56.998Z","avatar_url":"https://github.com/Kalebu.png","language":"Python","funding_links":["https://patreon.com/kalebujordan"],"categories":[],"sub_categories":[],"readme":"# [Nida](https://kalebu.github.io/Nida/)\n\nUnofficial package for fetching users information based on National ID Number made by [kalebu](https://github.com/Kalebu/)\n\n[![Releases](https://badgen.net/github/releases/kalebu/nida)](https://github.com/Kalebu/nida)\n[![Downloads](https://pepy.tech/badge/nida)](https://pepy.tech/project/nida)\n[![Downloads](https://pepy.tech/badge/nida/month)](https://pepy.tech/project/nida)\n[![Downloads](https://pepy.tech/badge/nida/week)](https://pepy.tech/project/nida)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Installation\n\nYou can install it directly or using pip\n\nHere how to install directly\n\n```bash\ngit clone https://github.com/Kalebu/Nida\ncd Nida\nNida -\u003e python setup.y install\n```\n\nHere how to install from pip\n\n```bash\npip install nida\n```\n\n## Usage\n\nTo fetch user information based on ID number do this;\n\n```python\n\u003e\u003e\u003e from nida import load_user\n\u003e\u003e\u003e user_detail = load_user(national_id='XXXXXXXXX')\n\u003e\u003e\u003e print(user_detail)\nuser\n{'Nin': 'XXXXXX', 'Firstname': 'XXXXXX', 'Middlename': 'XXXXXX', 'Surname': 'XXXXXX', 'Othernames': 'XXXXXX', 'Sex': 'XXXXXX', 'Dateofbirth': 'XXXXXX', 'Residentregion': 'XXXXXX', 'Residentdistrict': 'XXXXXX', 'Residentward': 'XXXXXX', 'Residentvillage': 'XXXXXX', 'Residentstreet': 'XXXXXX', 'Residentpostcode': 'XXXXXX', 'Permanentregion': 'XXXXXX', 'Permanentdistrict': 'XXXXXX', 'Permanentward': 'XXXXXX', 'Permanentvillage': 'XXXXXX', 'Permanentstreet': 'XXXXXX', 'Birthcountry': 'XXXXXX', 'Birthregion': 'XXXXXX', 'Birthdistrict': 'XXXXXX', 'Birthward': 'XXXXXX', 'Nationality': 'XXXXXX', 'Phonenumber': 'XXXXXX', 'Maritalstatus': 'XXXXXX', 'Occupation': 'XXXXXX', 'Primaryschooleducation': 'XXXXXX', 'Primaryschooldistrict': 'XXXXXX', 'Primaryschoolyear': 'XXXXXX', 'Photo': 'XXXXXX', 'Signature': 'XXXXXX', 'Nationalidnumber': 'XXXXXX', 'Lastname': 'XXXXXX'}\n```\n\nYou can access user infromation by using keys and attributes just as shown below;\n\n```python\n\u003e\u003e\u003e user_detetail['Firstname']\n'XXXXXX'\n\u003e\u003e\u003e user_detail.get('Middlename')\n'XXXXXX'\n\u003e\u003e\u003e user_detail.Lastname\n'XXXXXX'\n```\n\n## Image and Signature are currently not supported (Depreciated !!)\n\nNational ID Photo and Signature are auto converted into PIL Images and you can easily save just as shown below;\n\n```python\n\u003e\u003e\u003e user_detail.Photo.save('National_ID.png')\n\u003e\u003e\u003e user_detail.Signature.save('Signature.png')\n```\n\nIf you want the data to be in the same from an API without any side effect preprocessing do this instead while loading user;\n\n```python\n\u003e\u003e\u003e user_detail = load_user('xxxxxxxxxx', json = True)\n\u003e\u003e\u003e print(user_detail)\n{\n    ....\n}\n```\n\n## Give it star\n\nDid you find this repository useful to you ? Well then give it a star so as more people can get to know about it;\n\n## Issues\n\nAre you facing any issue with usage of the package, just raise an issue and I looking to fixing it as soon as I can.\n\n## Contributions\n\nIf there is anything yould would like to add warmly welcome, Just fork it\n\n## Disclaimers\n\nThis is not an official package, therefore I'm not responsible for any misinformation or misuse of the package of any kind !!!\n\n## Credits\n\nAll the credits to [Kalebu](https://github.com/Kalebu/) and [StackOverflow comment](https://stackoverflow.com/questions/53369396/how-to-integrate-national-identification-authority-nida-api-for-tanzania) from [dbrax](https://stackoverflow.com/users/6131960/emanuel-paul-mnzava)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkalebu%2Fnida","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkalebu%2Fnida","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkalebu%2Fnida/lists"}