This is what Mike told me to add.

AS Information for a Domain

To help better understand how IP addresses are related to each other and to the regional registries, the API can provide data about ASN and IP relationships. You can also find out more about the IP space associated with an AS with this endpoint and correlate BGP routing information between AS.

This area of the API is functionally similar to the AS View.

ASN for an IP Address

It can be helpful when querying IP to find which AS (Autonomous System) an IP address is associated with. The AS is part of the BGP routing for that IP.

To return the AS information for an IP, use the endpoint /bgp_routes/ip/. A valid result will return an array of hash references. The hash reference will contain information about the AS such as the ASN, the CIDR prefix of the AS, the Internet Registry (RIR) number (0 through 6), the Description of the AS and the creation date for the AS.

An empty response will return an empty array reference: [ ]

The IR number corresponds to one of the 5 Regional Internet Registries (RIR).

Registry Number
Region

Registry 1

AfriNIC: Africa

Registry 2

APNIC: Asia, Australia, New Zealand, and neighboring countries.

Registry 3

ARIN: United States, Canada, several parts of the Caribbean region, and Antarctica.

Registry 4

LACNIC: Latin America and parts of the Caribbean region.

Registry 5

RIPE NCC: Europe, Russia, the Middle East, and Central Asia.

Registry 0

Unknown / Not Available

sample query:

curl -H "Authorization: Bearer %YourToken%" "https://investigate.api.umbrella.com/bgp_routes/ip/123.173.23.234/as_for_ip.json"

Parameter for input

Field
Type
Description

ip

string

IPv4 IP address for which to obtain the AS information

Returned value for output if Success 200

Field
Type
Description

creation_date

string

Date when AS was first created.

ir

integer

The IR number corresponds to one of the 5 Regional Internet Registries (RIR). Please see table above for mappings.

description

string

Network Owner Description as provided by the network owner.

asn

string

Autonomous System Number (ASN) associated with this IP address.

cidr

string

IP CIDR for the ASN.

GET https://investigate.api.umbrella.com/bgp_routes/ip/ip/as_for_ip.json
REQUEST
curl --include \
     --header "Authorization: Bearer %YourToken%" \
https://investigate.api.umbrella.com/bgp_routes/ip/{ip}/as_for_ip.json
    
RESPONSE (HTTP 200, Content-Type: application/json)
[
  {
    "creation_date": "2002-08-01",
    "ir": 2,
    "description": "CHINANET-BACKBONE No.31,Jin-rong Street,CN 86400",
    "asn": 4134,
    "cidr": "123.172.0.0/15"
  }
]
    

Prefix routing information for an AS

Queries can also be about a specific AS (Autonomous System) to find which CIDR and Geolocations are associated with that AS.

To return the IP and Geolocation information for an AS, use the endpoint /bgp_routes/asn/.

A found response to a valid ASN will return an array of hash references. Each hash reference will contain two keys: geo and cidr. Geo is a hash reference with the country name and country code (the code corresponds to the country code list for ISO-3166-1 alpha-2). CIDR contains the IP prefix for this ASN.

An empty response will return an empty array reference: [ ]

Sample query:

curl -H "Authorization: Bearer %YourToken%" "https://investigate.api.umbrella.com/bgp_routes/asn/11425/prefixes_for_asn.json"

Parameter for input

Field
Type
Description

asn

string

Autonomous System Number (ASN) for the AS.

Returned value for output if Success 200

Field
Type
Description

cdir

array

Array of the CIDR Range of IP addresses associated with this AS.

geo

array

Geo is a hash reference with the country name and country code (the code corresponds to the country code list for ISO-3166-1 alpha-2). That list is here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

GET https://investigate.api.umbrella.com/bgp_routes/asn/asn/as_for_ip.json
REQUEST
curl --include \
     --header "Authorization: Bearer %YourToken%" \
https://investigate.api.umbrella.com/bgp_routes/asn/{asn}/as_for_ip.json
    
RESPONSE (HTTP 200, Content-Type: application/json)
[
  {
    "cidr": "98.143.32.0/20",
    "geo": {
      "country_name": "United States",
      "country_code": "US"
    }
  }
]
    

AS Information for a Domain