nordicsemiconductor / e118-iin-list-js

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

e118-iin-list

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

Note
Up-to-date with Operational Bulletin No. 1285 (1.II.2024) and also includes E.164 shared country code entries (which has some overlapping entries).

Data source as Google Spreadsheet.

Note: There is actually a database 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 (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

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.

ITU-T Recommendation E.118 Card numbering structure (Source)

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).

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

e118-iin-list-js's Issues

Could not identify ICCID 89852202401310XXXXXX

Please provide details about the SIM vendor.

• This is a SoftSIM.

Could not identify ICCID 89370000000021XXXXXX

Could not identify ICCID 89999112400717XXXXXX

Could not identify ICCID 89999112400717XXXXXX

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Repository problems

These problems occurred while renovating this repository. View logs.

• WARN: Fallback to renovate.json file as a preset is deprecated, please use a default.json file instead.

This repository currently has no open or pending branches.

Detected dependencies

github-actions

.github/workflows/sync-issue-labels.yaml

• actions/checkout v4
• ubuntu 22.04

.github/workflows/test-and-release.yaml

• actions/checkout v4
• actions/setup-node v4
• ubuntu 22.04

.github/workflows/update-repo-info.yaml

• actions/checkout v4
• ubuntu 22.04

npm

package.json

• @bifravst/eslint-config-typescript 6.1.1
• @bifravst/prettier-config 1.0.0
• @commitlint/cli 19.3.0
• @commitlint/config-conventional 19.2.2
• @types/node 20.13.0
• csv-parser 3.0.0
• husky 9.0.11
• node >=20
• npm >=10

---

• Check this box to trigger a request for Renovate to run again on this repository

Add support for Baidu ICCIDs (which have letters in them), e.g. 898604B719227100nnnn

TIL: the Chinese telco Baidu decided to break the e.118 standard which defines the identifiers for SIM cards (ICCID) in order to be able to encode custom data instead of using it as a true serial number.
https://www.xingsuyun58.com/907996.html

Full details here: https://baike.baidu.com/item/iccid/5181544

The letter is used to designate segments (which group operators).

Example: 898604B719227100nnnn (n is an integer)