Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bifravst/e118-iin-list

List of issuer identifier numbers for the international telecommunication charge card (ITU-T E.118)
https://github.com/bifravst/e118-iin-list

e118 iccid iin iot issuer itu-t nrf-asset-tracker

Last synced: about 1 month ago
JSON representation

List of issuer identifier numbers for the international telecommunication charge card (ITU-T E.118)

Host: GitHub
URL: https://github.com/bifravst/e118-iin-list
Owner: bifravst
License: bsd-3-clause
Created: 2022-02-02T13:39:28.000Z (almost 3 years ago)
Default Branch: saga
Last Pushed: 2024-10-23T18:57:33.000Z (2 months ago)
Last Synced: 2024-10-25T06:54:35.810Z (about 2 months ago)
Topics: e118, iccid, iin, iot, issuer, itu-t, nrf-asset-tracker
Language: TypeScript
Homepage: https://github.com/bifravst/e118-iin-list#readme
Size: 2.77 MB
Stars: 10
Watchers: 4
Forks: 2
Open Issues: 3
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        # e118-iin-list [![npm version](https://img.shields.io/npm/v/e118-iin-list.svg)](https://www.npmjs.com/package/e118-iin-list)

[![GitHub Actions](https://github.com/bifravst/e118-iin-list/workflows/Test%20and%20Release/badge.svg)](https://github.com/bifravst/e118-iin-list/actions)

[![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)

[![@commitlint/config-conventional](https://img.shields.io/badge/%40commitlint-config--conventional-brightgreen)](https://github.com/conventional-changelog/commitlint/tree/master/@commitlint/config-conventional)

[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier/)

[![ESLint: TypeScript](https://img.shields.io/badge/ESLint-TypeScript-blue.svg)](https://github.com/typescript-eslint/typescript-eslint)

List of issuer identification numbers for the international telecommunication

charge card

([ITU-T E.118](https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-E.118-200605-I!!PDF-E&type=items)).

> **Note**  

> Up-to-date with

> [Operational Bulletin No. 1295 (1.VII.2024)](https://www.itu.int/pub/T-SP-OB.1295-2024)

> and also includes

> [E.164 shared country code entries](http://www.itu.int/net/itu-t/inrdb/e164_intlsharedcc.aspx?cc=881,882,883)

> (which has some overlapping entries).

Data source as

[Google Spreadsheet](https://docs.google.com/spreadsheets/d/1ErJzksU5bF2YA8tQQ9QJleEZHsdvDRDk0Rvi0nf3fh4/edit?usp=sharing).

> _Note:_ There is actually

> [a database](https://www.itu.int/net/itu-t/inrdb/secured/e118iin.aspx) for

> this information, but the access is restricted to ITU-T Sector Members. 🤷

## Motivation

Since E.118's issuer identification number is of variable length (it can be 4–7

digits) an [ICCID](https://en.wikipedia.org/wiki/E.118#ICCID) (the serial number

of SIM cards) needs to be matched against a list of known IINs in order to

determine the SIM issuer.

## Usage

    npm install e118-iin-list

```typescript

import { identifyIssuer } from "e118-iin-list";

const issuer = identifyIssuer("89450421180216254864");

if (issuer !== undefined) {

  console.log(issuer.companyName); // Telia Sonera A/S

}

```

### CLI

You can identify issuers directly from your command line:

    $ npx e118-iin-list 89450421180216254864

    {

      "iin": 894504,

      "countryCode": 45,

      "issuerIdentifierNumber": "04",

      "countryName": "Denmark",

      "companyName": "Telia Sonera A/S"

    }

> _Note:_ if your ICCID is not recognized, please open a new issue

> [in this repository](https://github.com/bifravst/e118-iin-list/issues/new).

## ITU-T Recommendation E.118 Card numbering structure ([Source](https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-E.118-200605-I!!PDF-E&type=items))

The numbering of the card to be issued by OAs shall be as follows based on

ISO/IEC 7812-1 (Identification cards – Identification of issuers – Part 1:

Numbering system) and ISO/IEC 7812-2 (Identification cards – Identification of

issuers – Part 2: Application and registration procedures).

![E.118 Schema](./docs/fig1.png)

The maximum length of the visible card number (primary account number) shall be

19 characters and is composed of the following subparts (see Figure 1):

- Major Industry Identifier (MII);

- country code;

- issuer identifier;

- individual account identification number;

- parity check digit computed according to the Luhn formula (see ISO/IEC 7812-1,

  Annex B). In addition to the parity check digit, OAs may incorporate a

  validation check device in some location on the card which could be changed

  when new cards are issued.

### Notes

- the Major Industry Identifier (MII) is always `89` (_telecommunication

  purposes_)

- the Country Code is a positive integer (no leading zeros)

- the Issuer Identifier (IIN) is a _string_ (it has leading zeros) and can be

  entirely made up of `0`

## Generating the list

Sources:

- http://www.itu.int/pub/T-SP-E.118

- https://www.itu.int/pub/T-SP-OB

- http://www.itu.int/net/itu-t/inrdb/e164_intlsharedcc.aspx?cc=881,882,883

Process:

1. Download the latest Word Documents from http://www.itu.int/pub/T-SP-E.118,

   and copy and past the table into a Google Spreadsheet

2. Download the operational bulletins from https://www.itu.int/pub/T-SP-OB and

   incorporate the changes into the spreadsheet

3. Export list of shared country codes (E.164) from

   http://www.itu.int/net/itu-t/inrdb/e164_intlsharedcc.aspx?cc=881,882,883 and

   filter out `CRS` records (inactive), add to the spreadsheet

4. Export that to CSV and store it as `list.csv`

5. Convert to JSON using `npm run convert`