ASN Extended Receiving From Info API
This API returns a paginated list of the networks that a given Autonomous System (AS) is currently receiving traffic from — its upstream and peering relationships on the receiving side.
It is a companion to the ASN Info Extended API, broken out as a separate paginated endpoint for cases where the full receiving-from list is large and you need to retrieve it in controlled batches. Use the batchSize and offset parameters to page through the results.
GET
https://api-bdc.net/data/asn-info-receiving-fromParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
asn | string | Optional | Autonomous System Number as numeric or ASN format (e.g. 123 or AS123 or ASN123) |
batchSize | integer (int32) | Optional | number of receivingFrom entries to retrieve. 50 is the hard limit |
offset | integer (int32) | Optional | the number of receivingFrom entries to skip |
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 |
key | string | Optional | Your API key |
Responses
200OK
Sample Request
https://api-bdc.net/data/asn-info-receiving-from?asn=AS14618&batchSize=10&offset=0&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 paginated list of Autonomous Systems from which this ASN receives traffic (upstream providers), ordered by global rank.
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").
400Bad request
Sample Response
JSON View
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