ASN Info API

On this page

An Autonomous System (AS) is a collection of IP routing prefixes managed by a single administrative entity — typically an ISP, hosting provider, university, or large organisation. Each AS is identified by a globally unique Autonomous System Number (ASN), which governs how it exchanges routing information with neighbouring systems.

This API returns key information about an AS when given its ASN: registration details, the IPv4 address space it announces, and its ranking relative to other autonomous systems.

For a deeper explanation of how autonomous systems fit into the broader IP routing fabric — and why they matter for geolocation — see IP Geolocation Demystified and The Next Generation IP Geolocation Service.

Endpoint

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=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
rankintegerGlobal rank by total number of IP addresses announced. Omitted when the ASN is not ranked (i.e. ASNs with no active IP announcements)
rankTextstringHuman-readable global rank string including the total number of ranked ASNs (e.g. "#297 out of 79,835"). Omitted when the ASN is not ranked

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