ASN Info Extended API
This API extends the ASN Info API with two additional data sets: the full list of networks the AS receives traffic from, and the networks it transits traffic to. It also returns the geographic coordinates of the AS's most active operating region, where available, derived from BigDataCloud's proprietary network analysis.
The underlying data is updated every two hours, making it useful for network engineers and security teams who need a current picture of an AS's routing relationships — for topology analysis, route leak detection, or understanding peering arrangements.
GET
https://api-bdc.net/data/asn-info-fullParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
asn | string | Optional | Autonomous System Number as numeric or ASN format (e.g. 123 or AS123 or ASN123) |
localityLanguage | string | Optional | Preferred 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 |
peersCap | integer (int32) | Optional | This parameter caps the max number of 'receivingFrom' and 'transitTo' entries to retrieve. The default value and the hard limit are 50 |
key | string | Optional | Your API key |
Responses
200OK
Sample Request
https://api-bdc.net/data/asn-info-full?asn=AS14618&localityLanguage=en&key=[YOUR API KEY]Sample Response
JSON View
Response Schema
asnstringThe Autonomous System Number in prefixed string format (e.g. "AS13335").
asnNumericintegerThe Autonomous System Number as an unsigned integer (e.g. 13335).
organisationstringThe organisation or entity the AS is registered for, as recorded in the RIR database.
namestringThe short handle or network name assigned to the AS by the RIR (e.g. "CLOUDFLARENET").
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
totalReceivingFromintegerThe total number of active Autonomous Systems from which this ASN receives traffic (upstream providers).
rankintegerGlobal rank by total number of IP addresses announced
▶receivingFromarrayThe list of active Autonomous Systems from which this ASN receives traffic (upstream providers). Limited to the 50 most prominent entries.
asnstringThe Autonomous System Number in prefixed string format (e.g. "AS13335").
asnNumericintegerThe Autonomous System Number as an unsigned integer (e.g. 13335).
organisationstringThe organisation or entity the AS is registered for, as recorded in the RIR database.
namestringThe short handle or network name assigned to the AS by the RIR (e.g. "CLOUDFLARENET").
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
totalIpv4AddressesintegerTotal number of IP addresses announced by the AS
rankintegerGlobal rank by total number of IP addresses announced
rankTextstringHuman-readable global rank string including the total number of ranked ASNs (e.g. "#297 out of 79,835").
rankTextstringHuman-readable global rank string including the total number of ranked ASNs (e.g. "#297 out of 79,835").
totalTransitTointegerThe total number of active Autonomous Systems to which this ASN provides transit (downstream peers).
▶transitToarrayThe list of active Autonomous Systems to which this ASN provides transit. Limited to the 50 most prominent downstream peers.
asnstringThe Autonomous System Number in prefixed string format (e.g. "AS13335").
asnNumericintegerThe Autonomous System Number as an unsigned integer (e.g. 13335).
organisationstringThe organisation or entity the AS is registered for, as recorded in the RIR database.
namestringThe short handle or network name assigned to the AS by the RIR (e.g. "CLOUDFLARENET").
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
totalIpv4AddressesintegerTotal number of IP addresses announced by the AS
rankintegerGlobal rank by total number of IP addresses announced
rankTextstringHuman-readable global rank string including the total number of ranked ASNs (e.g. "#297 out of 79,835").
▶confidenceAreaarrayThe most active geographical area detected for this ASN, represented as a closed polygon of latitude/longitude coordinates. Useful for mapping the ASN's primary operational footprint.
latitudenumberLatitude in EPSG:4326 projection, as used in GPS
longitudenumberLongitude in EPSG:4326 projection, as used in GPS
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