ASN Info API

An autonomous system (AS) is a collection of connected Internet Protocol (IP) routing prefixes managed by one or more network operators on behalf of a single administrative entity or domain. It has a single and clearly defined external routing policy.

An autonomous system number (ASN) is a unique number used to identify an autonomous system. It enables that system to exchange exterior routing information with other neighbouring autonomous systems.

A detailed two-part blog post that explains the fundamentals of these systems and the role of AS is available below:

 

The AS Info APIs provide valuable information about the autonomous systems which allows you to identify the ownership of the systems and discover their neighbouring systems.

This API returns extended and detailed information about an Autonomous System (AS) when provided with an AS number. The information includes the registration, IPv4 address space announcements and ranking.

 

GEThttps://api-bdc.net/data/asn-info

Parameters

ParameterTypeRequiredDescription
asnstringOptionalAutonomous System Number as numeric or ASN format (e.g. 123 or AS123 or ASN123)
localityLanguagestringOptionalPreferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. If the requested language is not available for a requested location, it will default to English. If no English variant is known, will provide the native, local names
keystringOptionalYour API key

Responses

200OK

Sample Request

https://api-bdc.net/data/asn-info?asn=AS14618&localityLanguage=en&key=[YOUR API KEY]

Sample Response

JSON View

Response Schema

asnstringAutonomous System Number string
asnNumericintegerAutonomous System Number
organisationstringRegistered Organisation
namestringRegistered name
registrystringThe Regional Internet Registry (RIR) the AS is registered with
registeredCountrystringRegistered Country ISO 3166-1 Alpha-2 code
registeredCountryNamestringRegistered Country localised name. The language is as defined by the 'localityLanguage' request parameter
registrationDatestringRegistration date in 'yyyy-mm-dd' format
registrationLastChangestringRegistration modification date in 'yyyy-mm-dd' format
totalIpv4AddressesintegerTotal number of IP addresses announced by the AS
totalIpv4PrefixesintegerTotal number of ipV4 BGP prefixes announced by the AS
totalIpv4BogonPrefixesintegerTotal number of ipV4 bogon prefixes announced by the AS
totalIpv6PrefixesintegerTotal number of ipV6 BGP prefixes announced by the AS
totalIpv6BogonPrefixesintegerTotal number of ipV6 bogon prefixes announced by the AS
rankintegerGlobal rank by total number of IP addresses announced
rankTextstringGlobal rank by total number of IP addresses announced including total
403Access denied, or your quota limit has exceeded

Sample Response

JSON View
404Found no valid entry for the request

Sample Response

JSON View
500An error has occurred and did not complete your request. Please try again

Sample Response

JSON View