ASN Info Extended API

On this page

Introduction
Endpoint
Parameters
Responses
200 — OK
403 — Access denied
404 — Found no valid entry for the request
500 — An error has occurred and did not complete your request. Please try again

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.

Endpoint

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

Parameters

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=AS16509&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

registrationDatestringInitial registration date of the autonomous system in 'yyyy-MM-dd' format. This field is omitted when unavailable from the source Regional Internet Registry.

registrationLastChangestringDate of the most recent registration update or modification in 'yyyy-MM-dd' format. This field is omitted when unavailable from the source Regional Internet Registry.

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. Omitted when the ASN is not ranked (i.e. ASNs with no active IP announcements)

▶receivingFromarrayThe list of active Autonomous Systems from which this ASN receives traffic (upstream providers). Limited to the 50 most prominent entries.