Networks by CIDR API

On this page

This API returns all networks currently announced on BGP within a specified CIDR range. Given a CIDR block, it returns the active sub-prefixes being routed within it, along with their ASN and registration details.

It's useful for network auditing, prefix delegation analysis, and understanding how a particular IP range is being announced and routed in the current global routing table. The depthLimit parameter controls how deep into sub-prefix nesting the API will recurse.

Endpoint

GEThttps://api-bdc.net/data/network-by-cidr

Parameters

ParameterTypeRequiredDescription
cidrstringRequiredCIDR range in an x.x.x.x/y format. Where x: (0-255), y: (0-32)
depthLimitinteger (int32)OptionalDefines how many hierarchical levels down to include in the response Default: 1
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 Default: en
subnetsBatchSizeinteger (int32)OptionalNumber of subnetwork entries to retrieve. Defaults to 20 if omitted; 20 is the hard limit Default: 20
subnetsOffsetinteger (int32)OptionalThe number of subnetwork entries to skip. Defaults to 0 if omitted Default: 0
keystringOptionalYour API key

Responses

200OK

Sample Request

https://api-bdc.net/data/network-by-cidr?cidr=8.0.0.0/8&depthLimit=2&localityLanguage=en&key=[YOUR API KEY]

Sample Response

JSON View

Response Schema

cidrstringThe requested CIDR range (e.g. "1.1.1.0/24").
parentstringParent network in CIDR format
▶networksarrayArray of range and/or announced-network items that together cover the requested CIDR. Returned only when the CIDR is not itself a single announced prefix; omitted when `network` is present. Each item is either type=range (unannounced block with nested subnets) or type=network (announced prefix).
cidrstringThe CIDR notation of this network range (e.g. "8.0.0.0/9")
typestringThe type of this result item. Always "range" for unannounced ranges
deepCountintegerThe total count of child networks at all nested levels within this range
totalAnnouncedintegerThe total number of IP addresses actively announced on BGP within this range
sizeintegerThe total number of IP addresses in this network range
bogonsCountintegerThe count of bogon prefixes within this range
subnetsarray of IPrefixTreeResultArray of child network objects representing immediate subnets within this range. Recursive: same structure as parent.
registrystringThe Regional Internet Registry (RIR) that administers the network block (e.g. ARIN, RIPE, APNIC, LACNIC, AFRINIC, IANA).
registryStatusstringThe registration status of the network block as recorded by the RIR (e.g. "assigned", "allocated", "reserved").
registeredCountrystringRegistered Country ISO 3166-1 Alpha-2 code
registeredCountryNamestringRegistered Country name localised to the language is as defined by 'localityLanguage' request parameter
organisationstringThe organisation or entity the network block is registered for, as recorded in the RIR database.
isReachableGloballybooleanIndicates whether the network was announced on BGP and reachable globally or not
isBogonbooleanIndicates whether the IP address is excluded from public Internet use by the authorities but announced into the global routing table via BGP
bgpPrefixstringThe BGP prefix detected on the global network, announcing the network
bgpPrefixNetworkAddressstringThe first (network) address of the BGP prefix range.
bgpPrefixLastAddressstringThe last (broadcast) address of the BGP prefix range.
totalAddressesintegerNumber of IP addresses in the Network. For IPv6 networks, the value can range up to a 128-bit unsigned integer
▶carriersarrayList of Autonomous Systems (AS) announcing this network 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
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
▶viaCarriersarrayList of Autonomous Systems (AS) detected at the last BGP hop before the network carriers. Capped to the 5 most significant upstream peers.
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. 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
totalSubnetsintegerTotal number of subnetworks detected
▶networkobjectnetwork object
registrystringThe Regional Internet Registry (RIR) that administers the network block (e.g. ARIN, RIPE, APNIC, LACNIC, AFRINIC, IANA).
registryStatusstringThe registration status of the network block as recorded by the RIR (e.g. "assigned", "allocated", "reserved").
registeredCountrystringRegistered Country ISO 3166-1 Alpha-2 code
registeredCountryNamestringRegistered Country name localised to the language is as defined by 'localityLanguage' request parameter
organisationstringThe organisation or entity the network block is registered for, as recorded in the RIR database.
isReachableGloballybooleanIndicates whether the network was announced on BGP and reachable globally or not
isBogonbooleanIndicates whether the IP address is excluded from public Internet use by the authorities but announced into the global routing table via BGP
bgpPrefixstringThe BGP prefix detected on the global network, announcing the network
bgpPrefixNetworkAddressstringThe first (network) address of the BGP prefix range.
bgpPrefixLastAddressstringThe last (broadcast) address of the BGP prefix range.
totalAddressesintegerNumber of IP addresses in the Network. For IPv6 networks, the value can range up to a 128-bit unsigned integer
▶carriersarrayList of Autonomous Systems (AS) announcing this network 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
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
▶viaCarriersarrayList of Autonomous Systems (AS) detected at the last BGP hop before the network carriers. Capped to the 5 most significant upstream peers.
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. 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
totalSubnetsintegerTotal number of subnetworks detected
▶subnetsarrayThe array of subnetwork objects
startAddressstringFirst IPv4 address of the subnet. In string format
endAddressstringLast IPv4 address of the subnet. In string format
isCellularbooleanReturns 'true' if the subnetwork was detected as servicing cellular network clients, omitted otherwise
organisationstringOrganisation or segment the network was registered for
registeredCountrystringRegistered Country ISO 3166-1 Alpha-2 code
registeredCountryNamestringRegistered Country name localised to the language as defined by 'localityLanguage' request parameter

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