Download IP address lists grouped by network provider (ASN)
Find a file
2022-08-02 06:20:38 +02:00
as Update 20220801-0434 2022-08-02 06:20:38 +02:00
as.csv Update 20220801-0434 2022-08-02 06:20:38 +02:00
LICENSE Add LICENSE 2021-12-01 07:21:17 +01:00
README.md Update README.md 2022-07-31 09:16:35 +02:00

ipverse-asn-ip

IPv4 and IPv6 subnets (e.g. 100.2.30.0/22) organized by announcing autonomous systems (AS). All subnets are aggregated to save space. The data is available in TXT and JSON format. This is a JSON example for AS1234:

{
  "asn": 1234,
  "handle": "FORTUM",
  "description": "Fortum",
  "subnets": {
    "ipv4": [
      "132.171.0.0/16",
      "137.96.0.0/16",
      "193.110.32.0/21"
    ],
    "ipv6": [
      "2405:1800::/32"
    ]
  }
}

Additionally, a list of autonomous systems with their AS number (ASN), AS name and description is provided in the as.csv file:

asn,handle,description
0,IANA-RSVD,"Internet Assigned Numbers Authority"
1,LVLT,"Level 3 Parent, LLC"
2,UDEL-DCN,"University of Delaware"
3,MIT-GATEWAYS,"Massachusetts Institute of Technology"
4,ISI,"University of Southern California"
5,SYMBOLICS,"WFA Group LLC"
6,BULL-HN,"ATOS IT Solutions and Services, Inc."
7,DSTL,"The Defence Science and Technology Laboratory"
.
.
.

This repository is updated daily.

Use cases

  • Firewalling, e.g. to ban all IP addresses from that notorious, Spam-friendly network provider
  • Route advertisment check, see if/how the routes of a specific autonomous system are seen (even over time, thanks to Git's changelog)
  • Find out more about a specific ASN (autonomous system number) using the provided lookup table (currently .csv format only) or use it in your own software project for bulk/offline use
  • Statistical analysis purposes, e.g. the number of public IPv4 addresses currently announced vs unused/unassigned
  • OSINT/CTI Cyber Threat Intelligence

How to use

To download the announced subnets for a specific autonomous system (AS1234 IPv4 adresses in this example), try:
$ curl https://raw.githubusercontent.com/ipverse/asn-ip/master/as/1234/ipv4-aggregated.txt

The same for all IPv6 subnets from AS1234:
$ curl https://raw.githubusercontent.com/ipverse/asn-ip/master/as/1234/ipv6-aggregated.txt

The data (IPv4 + IPv4 combined) is available in JSON format as well:
$ curl https://raw.githubusercontent.com/ipverse/asn-ip/master/as/1234/aggregated.json

To download the latest autonomous system lookup table used to enhance the generated route data:
$ curl https://raw.githubusercontent.com/ipverse/asn-ip/master/as.csv

If you plan to use the routing data for firewalling purposes, have a look at:

  • ipset-blacklistlist ipset/iptables based Bash script, IPv4 only
  • todo insert link to a popular project with nftables and IPv6 support

Yeah, but how to I get the ASN for an IP address?

Check out this excellent blog post: https://blog.jiayu.co/2018/10/quick-url-to-asn-lookups/