Skip to content

Bogon IP ranges, free with an account.

The IPv4 and IPv6 ranges reserved for private networking, loopback, documentation, testing and other special uses, which should never appear as a source or destination on the public internet. Each range is named, and the file is rebuilt daily.

Schema at a glance.

See documentation →

The database's schema and metadata are documented carefully. It is published as CSVGZ and MMDB. For each range and the RFC that reserves it, see Bogon IP address ranges.

start_ipend_ipname
10.0.0.010.255.255.255Private-Use
100.64.0.0100.127.255.255Shared Address Space
192.0.2.0192.0.2.255Documentation (TEST-NET-1)
2001:db8::2001:db8:ffff:ffff:ffff:ffff:ffff:ffffDocumentation
fc00::fdff:ffff:ffff:ffff:ffff:ffff:ffff:ffffUnique-Local
ID
bogon_ip_v1
Entries
80
Refresh
Daily
CSVGZ
1 KB
MMDB
5 KB

Downloading it from code.

Database API reference →

One call gets you the current Bogon IP build. Every official client wraps it three ways: straight to disk, a time-limited link you hand to your own runner, or bytes in memory. A file written to disk lands only once the whole transfer has arrived, and checksums() returns the published digests to verify it against.

download()
Streams the current build to a file, which lands only once the whole transfer has arrived, so a failed one never leaves a truncated file behind.
downloadUrl()
The time-limited link the API redirects to, for your own downloader, a job runner or a CDN pull.
downloadBytes()
The build in memory, for a small database or a pipeline that never touches a filesystem.
metadata()
Row count, file sizes and when the build last updated. Poll it and fetch only when a new one has landed.
checksums()
The md5, sha1, sha256 and sha512 digests of one file, to verify it once it lands.
import os
from internetdata import InternetData
client = InternetData(os.environ["INTERNETDATA_API_KEY"])
# what is in today's build, without moving the file
meta = client.database.metadata("bogon_ip_v1")
client.database.download("bogon_ip_v1", "mmdb", "./bogon_ip_v1.mmdb")
sums = client.database.checksums("bogon_ip_v1", "mmdb")
print(meta.updated, meta.entries, sums["sha256"])
load.pypip install internetdata
Also available for .NET, Ruby, Rust, Swift, Erlang, Perl and Zig. See all on GitHub →

Getting your hands on it.

Free with an account, and the file is yours: teams join Bogon IP against the traffic, logs and routing data they already hold, inside their own infrastructure.

Traffic filtering

A packet sourced from a bogon range on the public internet is typically misconfigured or spoofed: drop it or flag it at the edge.

Log hygiene

Tell private and reserved addresses apart from real ones before they reach an allowlist, a report or a model.

Free with an account
Sign up, then download it with your API key, from the API or any official client.
Checksums published per file — md5, sha1, sha256 and sha512.
The id fixes the schema, so a new build never changes the columns your parser reads.

An official client for every major language.

All SDKs on GitHub →

Twelve official clients for the languages you ship in, each wrapping the database endpoints — list what you are licensed for, poll a build, follow the download redirect, verify what landed. Install commands are in the docs.

On this page

Is it really free?

Yes. Create an account and download it with your API key, from the API or any official client.