Skip to content

Bogon AS numbers, free with an account.

The reserved and special-use AS number ranges that should never appear in a real BGP announcement: private use, documentation, unallocated. Each range carries IANA's description of it.

Schema at a glance.

See documentation →

The database's schema and metadata are documented carefully. It is published as CSVGZ.

start_asnend_asndescription
00Reserved
2345623456AS_TRANS
6449664511Reserved for use in documentation and sample code
6451265534Reserved for Private Use
42000000004294967294Reserved for Private Use
ID
bogon_asn_v1
Entries
14
Refresh
Daily
CSVGZ
264 B

Downloading it from code.

Database API reference →

One call gets you the current Bogon ASN 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_asn_v1")
client.database.download("bogon_asn_v1", "csvgz", "./bogon_asn_v1.csv.gz")
sums = client.database.checksums("bogon_asn_v1", "csvgz")
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 ASN against the traffic, logs and routing data they already hold, inside their own infrastructure.

Routing data

Flag announcements and records that reference private, documentation-only or otherwise invalid AS numbers.

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.