MCC-MNC.dev Mobile country & network codes database

About the data

3,042 networks · 227 countries · 963 operator-enriched rows

What the dataset is made of

Every row is keyed by its PLMN — the mobile country code (MCC) concatenated with the mobile network code (MNC), zero-padding preserved. The dataset is compiled and maintained by MCC-MNC.dev: it is built up from several sources and then manually reviewed and corrected. It is not a raw copy of any single source.

1. Global base register

The starting worldwide MCC/MNC register is seeded from mcc-mnc-list (an open-source list that tracks the ITU-T E.212 allocations, itself Wikipedia-derived and CC BY-SA 4.0). This gives the initial PLMN, country, brand, operator, status, type, bands and notes across all 3,042 rows.

2. Operator detail

For 963 rows we add operator-level detail — subscriber counts (in millions, with their reporting period), ownership groups, in-country rank, and radio-technology lines — drawn from public operator references (including Wikipedia's regional lists of mobile network operators) together with our own dataset. Where a source lists MCC/MNC codes we key on them; otherwise we attach the detail to the matching operator by name.

3. Curation & corrections

This is where the dataset stops being a scrape. Each release is reviewed and corrected by MCC-MNC.dev: codes are de-duplicated and cross-checked, statuses and operator names are normalised, mismatches are fixed, and market-reach figures are computed. The curation, merging logic and corrections are our own work — the published data reflects that editing, not any one upstream source verbatim.

Market reach

market_reach is computed, not copied: operator subscriptions ÷ total mobile subscriptions of the country, expressed as a percentage. Example: O2 Czech Republic reported 5.987 million subscribers (2021-Q2), which is 37.1% of the Czech Republic's total mobile subscriptions — market_reach: 37.1 with market_reach_basis: "country_total". Where a country total is not usable, the basis field says what was used instead (e.g. the sum of listed operators, or a share figure as published). Numerator and denominator can come from different reporting dates, so treat the percentage as indicative, not audited.

Licensing

All downloads and API responses are provided under Creative Commons Attribution-ShareAlike 4.0 (CC BY-SA 4.0). The dataset combines material from CC BY-SA sources (such as the Wikipedia-derived base register) with our own compilation, enrichment and corrections, and we release the whole under the same license so it stays freely reusable. You may use it commercially, but you must credit the source and share derived datasets under the same license. A sufficient attribution:

Data: MCC-MNC.dev (https://mcc-mnc.dev) — CC BY-SA 4.0

The mcc-mnc-list project that seeds the base register is MIT-licensed; that license applies to its code only, not the data.

Downloads

The complete dataset, no API key required:

FileContentsSize
networks.csv Flat CSV (RFC 4180), one network per row — the same columns as the API wire format. 440 KB
networks.json Full nested JSON: every network with its country block and, where available, the complete operator enrichment (approximate flags, source notes, numerator/denominator dates). 1.4 MB
networks.min.json The same JSON, minified for machine consumption. 1.0 MB
countries.json Country index: ISO codes, dial prefixes, and network counts per country. 38 KB

The same data is queryable through the REST API (free key required), including a /dataset endpoint that serves JSON, CSV or TSV.

Update cadence

The dataset is regenerated from its sources periodically — typically a few times per year, whenever the upstream lists change materially.

Honest caveats

Corrections & contact

Spotted a wrong MNC, a stale status, or a better subscriber figure? Open an issue on GitHub — corrections with a citable source are merged into the next regeneration. For anything else: hello@mcc-mnc.dev.