Network Data — MMDB

At a glance

A lookup returns

• bigdatacloud-network-bgp.mmdb: Asn, IsReachable, IsBogon, RegistryStatus and Registry for the BGP prefix containing the IP.
• bigdatacloud-network-rir.mmdb: Organisation, Country, Registry and RegistryLastModified for the registry range containing the IP.
• Asns-Basic.csv is in the same ZIP, so you can turn an Asn into an AS name without any other download.

What it's for

Origin ASN, reachability and registrant for any IP inside your internal systems, with no API call per lookup.

Not in it

Geolocation (see Compact MMDB or Complete MMDB); ASN operational areas and proxy, Tor and VPN lists (see Complete MMDB).

Scale

Millions of BGP prefixes and registry ranges. Manifest.csv has the exact counts for each release.

Licence

Flat Data Standard Licence: internal use by your company and its employees only.

Files in the archive

Keys

Both databases map each prefix or range to its record, so a lookup returns the keys below directly; there are no prefix or range keys.

How the files join

Not joined: look up bigdatacloud-network-rir.mmdb by IP address, and Manifest.csv describes the release.

BGP prefixes and registry ranges are separate views of the same address space: they don't share a key, and their boundaries don't line up. Look the IP up in each database on its own.

Sample data

Sample records from the 1 October 2026 release. Values change with each daily update.

bigdatacloud-network-bgp.mmdb

139.130.4.5       {"Asn": 1221, "IsReachable": true, "IsBogon": false, "RegistryStatus": "Assigned", "Registry": "Apnic"}
1.37.82.10        {"Asn": 132199, "IsReachable": true, "IsBogon": false, "RegistryStatus": "Assigned", "Registry": "Apnic"}
2001:8000::1      {"Asn": 1221, "IsReachable": true, "IsBogon": false, "RegistryStatus": "Assigned", "Registry": "Apnic"}
1.0.8.10          {"IsReachable": false, "IsBogon": false, "RegistryStatus": "Assigned", "Registry": "Apnic"}
205.209.150.1     {"Asn": 23338, "IsReachable": false, "IsBogon": true, "RegistryStatus": "Reserved", "Registry": "Arin"}
192.168.1.1       {"IsReachable": false, "IsBogon": false, "RegistryStatus": "Reserved", "Registry": "Iana"}

bigdatacloud-network-rir.mmdb

139.130.4.5       {"Organisation": "Telstra Limited", "Country": "AU", "Registry": "Apnic", "RegistryLastModified": "2024-05-10T00:50:24.0000000Z"}
1.37.82.10        {"Organisation": "Globe Telecoms", "Country": "PH", "Registry": "Apnic", "RegistryLastModified": "2021-02-17T07:28:15.0000000Z"}
2001:8000::1      {"Organisation": "Telstra Limited", "Country": "AU", "Registry": "Apnic", "RegistryLastModified": "2024-05-10T00:50:24.0000000Z"}
1.0.8.10          {"Organisation": "CHINANET Guangdong province network Data Communi..", "Country": "CN", "Registry": "Apnic", "RegistryLastModified": "2021-06-15T08:05:48.0000000Z"}

Each record carries only the keys that hold a value. Asn is supplied where the prefix is announced in BGP, as for 139.130.4.5, 1.37.82.10, 2001:8000::1 and 205.209.150.1. 205.209.150.1 is a bogon. 192.168.1.1 is private space, so BGP shows it as reserved.

Behaviour and edge cases

Supplied keys

Each record carries the keys that apply to it, and each key description says when it is supplied. Check that a key is present before you use it. Asn is supplied where the prefix is announced in BGP. RIR records carry Organisation, Country, Registry and RegistryLastModified. In Asns-Basic.csv, Organisation is supplied for every ASN (Private Use AS for an ASN with no registration record). AsnName, Registry and RegisteredCountry are supplied where the registry publishes them.

Private and reserved addresses

Addresses such as 10.0.0.0/8, 127.0.0.0/8, 100.64.0.0/10, 169.254.0.0/16, 192.168.0.0/16, ::1 and fc00::/7 return a BGP record with RegistryStatus Reserved, Registry Iana and IsReachable false. The RIR database returns whatever the registries publish for that range.

Unannounced prefixes and bogons

An unannounced prefix returns a BGP record with IsReachable false. Asn is supplied where the prefix is announced in BGP. Its RegistryStatus still tells you whether the space is assigned, available or reserved. A few prefixes have an Asn but IsReachable false: these are bogons, with IsBogon true.

IPv4 and IPv6

Each file answers both. IPv4 lives at ::/96, so ::a.b.c.d and IPv4-mapped ::ffff:a.b.c.d addresses answer from the IPv4 data (::ffff:139.130.4.5 returns the same record as 139.130.4.5).

No overlaps

BGP prefixes don't overlap, and registry ranges don't overlap, so an address matches at most one record in each database.

File conventions

The lookup files in this ZIP are UTF-8 with CRLF line endings, Manifest.csv included. Asns-Basic.csv starts with a byte-order mark (BOM), so use a BOM-aware reader. MMDB metadata: database_type is BigDataCloud-BgpPrefixes and BigDataCloud-RirInetnums, and build_epoch is the same moment as Build Complete in Manifest.csv. Full lists: lookup file conventions and MMDB conventions.

Download

Download from your BigDataCloud account, or automate it with your API key:

curl -fL -o bigdatacloud-network-mmdb.zip "https://www.bigdatacloud.com/download?package=network&format=mmdb&key=YOUR_API_KEY"

URL=$(curl -s -D - -o /dev/null -H 'x-bdc-key: YOUR_API_KEY' \
  "https://www.bigdatacloud.com/download?package=network&format=mmdb" \
  | awk 'tolower($1)=="location:" { sub(/\r$/, "", $2); print $2 }')
curl -fo bigdatacloud-network-mmdb.zip "${URL:?no download link: check the key and package}"

Updates and integrity

• Updated daily. Download on any schedule that suits you; updates are included in your subscription.
• Manifest.csv records the build time (Build Complete), the data timestamps and the row totals, then one row per other file in that ZIP with its byte count, so you can check a complete download and load. To check the ZIP itself, see Check a download.

Code samples

Origin ASN, AS name and registrant for an IP (Python). Install a reader with pip install maxminddb.

import csv
import maxminddb

# utf-8-sig skips the byte-order mark the file starts with
with open("Asns-Basic.csv", newline="", encoding="utf-8-sig") as f:
    asns = {row["Asn"]: row for row in csv.DictReader(f)}

with maxminddb.open_database("bigdatacloud-network-bgp.mmdb") as bgp, \
     maxminddb.open_database("bigdatacloud-network-rir.mmdb") as rir:
    for ip in ["139.130.4.5", "2001:8000::1", "1.0.8.10"]:
        route = bgp.get(ip) or {}
        reg = rir.get(ip) or {}
        asn = route.get("Asn")  # supplied where the prefix is announced in BGP
        name = asns.get(str(asn), {}).get("AsnName")
        print(ip, asn, name, route.get("IsReachable"), reg.get("Organisation"), reg.get("Country"))

# 139.130.4.5 1221 ASN-TELSTRA True Telstra Limited AU
# 2001:8000::1 1221 ASN-TELSTRA True Telstra Limited AU
# 1.0.8.10 None None False CHINANET Guangdong province network Data Communi.. CN

MMDB reader libraries are available for most languages, and they all work the same way: open the file, look up the IP, read the keys.

Related

• Network CSV
• Lookup files reference
• Downloads & automation
• Compact MMDB · Complete MMDB
• Overview