BGP Active Prefixes API
This API returns a paginated list of IPv4 or IPv6 prefixes currently announced on BGP — the routing protocol that governs how traffic moves between autonomous systems on the internet.
You can filter to bogon-only prefixes (unallocated or reserved address space that should not appear in global routing tables) or retrieve the full active prefix list. It's useful for route monitoring, bogon detection, and building tools that need a live view of the global routing table.
GET
https://api-bdc.net/data/prefixes-listParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
bogonsOnly | boolean | Optional | Limit to bogon routes only or not |
batchSize | integer (int32) | Optional | Requested batch size. Maximum value = 1000 |
offset | integer (int32) | Optional | Offset. Number of entries to skip |
sort | string, enum (bgpPrefix, bgpPrefixNetworkAddress, bgpPrefixLastAddress, registryStatus, isBogon, isAnnounced, carriers) | Optional | Sort response by a field value. Default value: bgpPrefixNetworkAddress |
order | string, enum (asc, desc) | Optional | Sort order. Default value: asc |
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 |
isv4 | boolean | Optional | Defines if the request is for ipv4 or ipv6 prefixes only. The 'false' value will make the response list ipv6 prefixes. When omitted, the ipv4 = 'true' value is assumed |
key | string | Optional | Your API key |
Responses
200OK
Sample Request
https://api-bdc.net/data/prefixes-list?bogonsOnly=false&batchSize=10&offset=0&localityLanguage=en&key=[YOUR API KEY]Sample Response
JSON View
Response Schema
totalintegerTotal prefixes found
offsetintegerNumber of entries skipped in result
batchintegerNumber of entries in the current batch
▶prefixesarrayArray of prefix entries returned
bgpPrefixstringBGP prefix in CIDR format
bgpPrefixNetworkAddressstringBGP prefix network (first) address
bgpPrefixLastAddressstringBGP prefix last address
registryStatusstringRegistration status
isBogonbooleanIndicates whether the IP address is excluded from public Internet use
by the authorities but announced into the global routing table via BGP
isAnnouncedbooleanIndicates whether the network was announced on BGP or not
▶carriersarrayList of Autonomous Systems (AS) announcing this prefix on BGP
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").
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
406Found too many result items. Please reduce the scope of your request
Sample Response
JSON View
500An error has occurred and did not complete your request. Please try again
Sample Response
JSON View