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_asn | end_asn | description |
|---|---|---|
| 0 | 0 | Reserved |
| 23456 | 23456 | AS_TRANS |
| 64496 | 64511 | Reserved for use in documentation and sample code |
| 64512 | 65534 | Reserved for Private Use |
| 4200000000 | 4294967294 | Reserved for Private Use |
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()downloadUrl()downloadBytes()metadata()checksums()import osfrom internetdata import InternetDataclient = InternetData(os.environ["INTERNETDATA_API_KEY"])# what is in today's build, without moving the filemeta = 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"])
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.
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.
No loose ends.
Is it really free?
Yes. Create an account and download it with your API key, from the API or any official client.
How often does this database rebuild?
Daily. The metadata call answers when the current build landed and how many rows it holds, before you fetch it.
Which formats does a build ship in?
Gzipped CSV for both open databases, and MMDB for Bogon IP as well. The schema section above names this one's.