BGP Active Prefixes API
Returns IPv4 or IPv6 address space routes/prefixes which are currently announced on BGP
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
asnstringAutonomous System Number string
asnNumericintegerAutonomous System Number
organisationstringRegistered Organisation
namestringRegistered name
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
rankTextstringGlobal rank by total number of IP addresses announced including total
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