{"id":22218968,"url":"https://github.com/ajamous/openmsisdnmapper","last_synced_at":"2026-01-06T01:07:40.527Z","repository":{"id":37942103,"uuid":"503091983","full_name":"ajamous/OpenMSISDNMapper","owner":"ajamous","description":"open source msisdn mapping dataset","archived":false,"fork":false,"pushed_at":"2023-04-28T17:34:55.000Z","size":1084,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-20T02:49:13.050Z","etag":null,"topics":["country-codes","dataset","e164","mcc","mccmnc","msisdn-validate","telephony"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ajamous.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"telecomsxchange"}},"created_at":"2022-06-13T19:40:43.000Z","updated_at":"2024-03-20T18:13:02.000Z","dependencies_parsed_at":"2022-09-17T09:20:59.407Z","dependency_job_id":null,"html_url":"https://github.com/ajamous/OpenMSISDNMapper","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajamous%2FOpenMSISDNMapper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajamous%2FOpenMSISDNMapper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajamous%2FOpenMSISDNMapper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajamous%2FOpenMSISDNMapper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ajamous","download_url":"https://codeload.github.com/ajamous/OpenMSISDNMapper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245416003,"owners_count":20611653,"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":["country-codes","dataset","e164","mcc","mccmnc","msisdn-validate","telephony"],"created_at":"2024-12-02T22:30:00.375Z","updated_at":"2026-01-06T01:07:40.488Z","avatar_url":"https://github.com/ajamous.png","language":null,"funding_links":["https://github.com/sponsors/telecomsxchange"],"categories":[],"sub_categories":[],"readme":"# OpenMSISDN Mapper \n\n\n**OpenMSISDN Mapper** is detailed and  high quality e.164 to e.212 mapping database. it is essential for accurare billing, reporting and routing purposes for voice and SMS traffic to have an accurate list.\n\n\n\n## Table of Contents\n\n* [Introduction](#introduction)\n* [Create the API](#create-the-api)\n* [Using the API](#using-the-api)\n* [Getting Help](#getting-help)\n* [Warranty](#warranty)\n* [Contribution](#contribuation)\n\n## Introduction\n\nIt is surprisingly difficult for communications providers and developers to find a good quality e.164 to e.212 mapping database,\nthis data set has been created and updated manually using over 10 different data sources. data is provided in the hope that it will be useful but WITHOUT ANY WARRANTY.\n\n\nYou can just open an use the raw json file `OpenMSISDNMapper.json ` with your fav text editor and/or convert it to any file format you want e.g. SQL or CSV and use it as you wish, you may also create a quick RESTful API server from the json file to use it from your application.\n\n\n\nThis API allows you to integrate and interact with **OpenMSISDN Mapper** data set\n\nThe data is provided in standard JSON responses and uses HTTP Status Codes to help determine results.\n\n## Create The API\n\n- cd to the project path\n- Install required packages\n```shell\nnpm install -g \n```\n- Run the API server \n\n```shell \njson-server --watch OpenMSISDNMapper.json \n\n```\n\n\n\n## Using The API\n\n1. Now you can open http://localhost:8080/lookup to list all records\n2. Lookup a specific country E.164 \u0026 E.212 data http://localhost:8080/lookup?Country=EGYPT\n3. Lookup a specific prefix_e164 data http://localhost:8080/lookup?prefix_e164=20\n4. Lookup a specific MCCMNC data http://localhost:8080/lookup?mccmnc_e212=60203\n5. Lookup a secondary MCCMNC data http://localhost:8080/lookup?mccmnc_secondary=1234\n\nSample Response:\n\n```json\n[\n  {\n    \"prefix_e164\": 202,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Fixed - Cairo\",\n    \"mccmnc_e212\": 0,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Fixed - Roc\",\n    \"mccmnc_e212\": 0,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 2011,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Etisalat\",\n    \"mccmnc_e212\": 60203,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20110,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Etisalat\",\n    \"mccmnc_e212\": 60203,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20111,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Etisalat\",\n    \"mccmnc_e212\": 60203,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20112,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Etisalat\",\n    \"mccmnc_e212\": 60203,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20114,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Etisalat\",\n    \"mccmnc_e212\": 60203,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20115,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Etisalat\",\n    \"mccmnc_e212\": 60203,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20117,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Etisalat\",\n    \"mccmnc_e212\": 60203,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 2012,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Orange\",\n    \"mccmnc_e212\": 60201,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20120,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Orange\",\n    \"mccmnc_e212\": 60201,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20122,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Orange\",\n    \"mccmnc_e212\": 60201,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20127,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Orange\",\n    \"mccmnc_e212\": 60201,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20128,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Orange\",\n    \"mccmnc_e212\": 60201,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 201,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Roc\",\n    \"mccmnc_e212\": 6020,\n    \"mccmnc_secondary\": \" 602 602999\"\n  },\n  {\n    \"prefix_e164\": 2010,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Vodafone\",\n    \"mccmnc_e212\": 60202,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20100,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Vodafone\",\n    \"mccmnc_e212\": 60202,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20101,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Vodafone\",\n    \"mccmnc_e212\": 60202,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20106,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Vodafone\",\n    \"mccmnc_e212\": 60202,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 20109,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - Vodafone\",\n    \"mccmnc_e212\": 60202,\n    \"mccmnc_secondary\": \"\"\n  },\n  {\n    \"prefix_e164\": 2015,\n    \"Country\": \"EGYPT\",\n    \"Network Description\": \"Mobile - We\",\n    \"mccmnc_e212\": 60204,\n    \"mccmnc_secondary\": \"\"\n  }\n]\n\n\n```\n\n\n\n\n## Getting Help\n\nHelp is provided by the community as soon as possible, you can open an issue here https://github.com/ajamous/MSISDN/issues .\n\n## Warranty\n\nOpenMSISDN Mapper  data is provided in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.\n\n## Contribution\n\nTo keep this list error free and useful for everyone, We expect community members to create pull requests to contribute back improvements to the data set. Once a pull request is opened, project authors will run a verification using HLR to verify the updated data is correct before it's merged to the master branch.\n\n**Submit your first contribution**\n\n1- Clone project `git clone https://github.com/ajamous/OpenMSISDNMapper/` .\n\n2- Create a new branch by issuing the command: `git checkout -b new_branch`\n\n3- Create a new remote for the upstream repo with the command: `git remote add upstream https://github.com/ajamous/OpenMSISDNMapper/`\n\n4- Switch to the new branch `git checkout -b new_branch`\n\n5- edit  `OpenMSISDNMapper.json ` using your preferred text editor \n\n6- Committing your changes `git commit -S -m \"Dial Code Improvmenth\"`\n\n7- push your changes ` git push -u origin new_branch`\n\nOnce you push the changes to your repo, the Compare \u0026 pull request button will appear in GitHub. Click it and next Open a pull request by clicking the `Create pull request button`\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajamous%2Fopenmsisdnmapper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fajamous%2Fopenmsisdnmapper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajamous%2Fopenmsisdnmapper/lists"}