{"id":20442579,"url":"https://github.com/bifravst/e118-iin-list","last_synced_at":"2025-04-12T23:38:06.477Z","repository":{"id":37397513,"uuid":"454789055","full_name":"bifravst/e118-iin-list","owner":"bifravst","description":"List of issuer identifier numbers for the international telecommunication charge card (ITU-T E.118)","archived":false,"fork":false,"pushed_at":"2025-04-12T02:32:35.000Z","size":2811,"stargazers_count":14,"open_issues_count":3,"forks_count":3,"subscribers_count":4,"default_branch":"saga","last_synced_at":"2025-04-12T23:37:57.303Z","etag":null,"topics":["e118","iccid","iin","iot","issuer","itu-t","nrf-asset-tracker"],"latest_commit_sha":null,"homepage":"https://github.com/bifravst/e118-iin-list#readme","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bifravst.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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}},"created_at":"2022-02-02T13:39:28.000Z","updated_at":"2025-04-12T02:32:38.000Z","dependencies_parsed_at":"2024-01-27T20:26:04.903Z","dependency_job_id":"9415cb8c-ec66-4d4b-a8e6-a7eeddcd0233","html_url":"https://github.com/bifravst/e118-iin-list","commit_stats":{"total_commits":656,"total_committers":4,"mean_commits":164.0,"dds":"0.25457317073170727","last_synced_commit":"2adb1c98bdf874347c703f75427a6443fa7953cc"},"previous_names":["bifravst/e118-iin-list"],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bifravst%2Fe118-iin-list","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bifravst%2Fe118-iin-list/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bifravst%2Fe118-iin-list/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bifravst%2Fe118-iin-list/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bifravst","download_url":"https://codeload.github.com/bifravst/e118-iin-list/tar.gz/refs/heads/saga","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248647255,"owners_count":21139081,"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":["e118","iccid","iin","iot","issuer","itu-t","nrf-asset-tracker"],"created_at":"2024-11-15T09:41:41.929Z","updated_at":"2025-04-12T23:38:06.472Z","avatar_url":"https://github.com/bifravst.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# e118-iin-list [![npm version](https://img.shields.io/npm/v/e118-iin-list.svg)](https://www.npmjs.com/package/e118-iin-list)\n\n[![GitHub Actions](https://github.com/bifravst/e118-iin-list/workflows/Test%20and%20Release/badge.svg)](https://github.com/bifravst/e118-iin-list/actions)\n[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)\n[![@commitlint/config-conventional](https://img.shields.io/badge/%40commitlint-config--conventional-brightgreen)](https://github.com/conventional-changelog/commitlint/tree/master/@commitlint/config-conventional)\n[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier/)\n[![ESLint: TypeScript](https://img.shields.io/badge/ESLint-TypeScript-blue.svg)](https://github.com/typescript-eslint/typescript-eslint)\n\nList of issuer identification numbers for the international telecommunication\ncharge card\n([ITU-T E.118](https://www.itu.int/rec/dologin_pub.asp?lang=e\u0026id=T-REC-E.118-200605-I!!PDF-E\u0026type=items)).\n\n\u003e [!NOTE]  \n\u003e Last update: 2024-12-20\n\n\u003e [!IMPORTANT]  \n\u003e Up-to-date with\n\u003e [the ITU-T E.118 Issuer Identifier Numbers database](https://www.itu.int/net/itu-t/inrdb/secured/e118iin.aspx)\n\u003e and also includes\n\u003e [E.164 shared country code entries](http://www.itu.int/net/itu-t/inrdb/e164_intlsharedcc.aspx?cc=881,882,883)\n\u003e (which has some overlapping entries).\n\nData source as\n[Google Spreadsheet](https://docs.google.com/spreadsheets/d/1ErJzksU5bF2YA8tQQ9QJleEZHsdvDRDk0Rvi0nf3fh4/edit?usp=sharing).\n\n## Motivation\n\nSince E.118's issuer identification number is of variable length (it can be 4–7\ndigits) an [ICCID](https://en.wikipedia.org/wiki/E.118#ICCID) (the serial number\nof SIM cards) needs to be matched against a list of known IINs in order to\ndetermine the SIM issuer.\n\n## Usage\n\n    npm install e118-iin-list\n\n```typescript\nimport { identifyIssuer } from \"e118-iin-list\";\n\nconst issuer = identifyIssuer(\"89450421180216254864\");\nif (issuer !== undefined) {\n  console.log(issuer.companyName); // Telia Sonera A/S\n}\n```\n\n### CLI\n\nYou can identify issuers directly from your command line:\n\n    $ npx e118-iin-list 89450421180216254864\n    {\n      \"iin\": 894504,\n      \"countryCode\": 45,\n      \"issuerIdentifierNumber\": \"04\",\n      \"countryName\": \"Denmark\",\n      \"companyName\": \"Telia Sonera A/S\"\n    }\n\n\u003e _Note:_ if your ICCID is not recognized, please open a new issue\n\u003e [in this repository](https://github.com/bifravst/e118-iin-list/issues/new).\n\n## ITU-T Recommendation E.118 Card numbering structure ([Source](https://www.itu.int/rec/dologin_pub.asp?lang=e\u0026id=T-REC-E.118-200605-I!!PDF-E\u0026type=items))\n\nThe numbering of the card to be issued by OAs shall be as follows based on\nISO/IEC 7812-1 (Identification cards – Identification of issuers – Part 1:\nNumbering system) and ISO/IEC 7812-2 (Identification cards – Identification of\nissuers – Part 2: Application and registration procedures).\n\n![E.118 Schema](./docs/fig1.png)\n\nThe maximum length of the visible card number (primary account number) shall be\n19 characters and is composed of the following subparts (see Figure 1):\n\n- Major Industry Identifier (MII);\n- country code;\n- issuer identifier;\n- individual account identification number;\n- parity check digit computed according to the Luhn formula (see ISO/IEC 7812-1,\n  Annex B). In addition to the parity check digit, OAs may incorporate a\n  validation check device in some location on the card which could be changed\n  when new cards are issued.\n\n### Notes\n\n- the Major Industry Identifier (MII) is always `89` (_telecommunication\n  purposes_)\n- the Country Code is a positive integer (no leading zeros)\n- the Issuer Identifier (IIN) is a _string_ (it has leading zeros) and can be\n  entirely made up of `0`\n\n## Generating the list\n\nSources:\n\n- https://www.itu.int/net/itu-t/inrdb/secured/e118iin.aspx\n- http://www.itu.int/net/itu-t/inrdb/e164_intlsharedcc.aspx?cc=881,882,883\n\nProcess:\n\n1. Export\n   [the database](https://www.itu.int/net/itu-t/inrdb/secured/e118iin.aspx) as\n   Excel spreadsheet and copy and past the table into a Google Spreadsheet\n2. Export list of shared country codes (E.164) from\n   http://www.itu.int/net/itu-t/inrdb/e164_intlsharedcc.aspx?cc=881,882,883 and\n   filter out `CRS` records (inactive), add to the spreadsheet\n3. Export that to CSV and store it as `list.csv`\n4. Convert to JSON using `npm run convert`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbifravst%2Fe118-iin-list","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbifravst%2Fe118-iin-list","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbifravst%2Fe118-iin-list/lists"}