Networks by CIDR API

Introduction

This API returns all the networks that are currently announced on Border Gateway Protocol (BGP) within a specified CIDR range.

Unprecedented Update Rate

  • BGP data: updated every 2 hours
  • Registry data: updated at least once a day

Example Response

The response is only available in JSON format. The below response should be expected for the following request:


https://api.bigdatacloud.net/data/network-by-cidr


Awaiting request submission...

API Pricing

  1. Monthly Subscription
    FREE 10,000 queries/month
    Additional 10,000 queries US$1.00/month
  2. Annual Subscription
    FREE 10,000 queries/month
    Additional 10,000 queries US$0.80/month

Request Format

NEW! Payload compression is supported, simply add Accept-Encoding: gzip header.
Use the form below to try out this API.

Parameter Your Input Value Description
cidr CIDR range in a x.x.x.x/y format. Where x: (0-255), y: (0-32)
depthLimit Defines how many hierarchical levels down to include in the response
bogonsOnly Limit to bogon routes only or not. Default – no limit
asn Autonomous System Number as numeric or ASN format (e.g. 123 or AS123 or ASN123)
localityLanguage

Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. Please note: 148 common world languages are supported, but not all languages are available for every location. If requested language is not available for a requested location it will default to English, if no English is available, the native, local names will be provided
key Your API key

Don't have an API Key? Click here to register and get your free API Key

If you already have a BigDataCloud account, to automatically fill this field with your Api Key.

The live query

https://api.bigdatacloud.net/data/network-by-cidr


CURL Example

curl -X GET --header 'Accept: application/json' 'https://api.bigdatacloud.net/data/network-by-cidr'


Visit our SDK page to access API clients in specific languages like Javascript, Python + PHP.


Response

Awaiting request submission...

Response Format

Field

Data type

Description

cidr

string

CIDR range to represent the response

parent

string

Parent network in CIDR format

networks

Array of <Range/Network> objects

Array of a network/range objects resembling the CIDR range of interest. Omitted if a single network

network

<Network> object

Network details. Omitted if multiple networks

API Endpoint

Endpoint: /data/network-by-cidr
Full URL: https://api.bigdatacloud.net/data/network-by-cidr

Data Objects

Network object

Field

Data type

Description

registry

string

The Regional Internet Registry (RIR) the network is registered with

registryStatus

string

Registration status

registeredCountry

string

Registered Country ISO 3166-1 Alpha-2 code

registeredCountryName

string

Registered Country name localised to the language is as defined by ‘localityLanguage’ request parameter

organisation

string

Registered for

isReachableGlobally

boolean

Indicates if the network was announced on BGP and reachable globally or not

isBogon

boolean

Indicates if the network in bogon

bgpPrefix

string

The latest BGP prefix announcement for the current network

bgpPrefixNetworkAddress

string

BGP prefix network (the first) address

bgpPrefixLastAddress

string

BGP prefix last address

totalAddresses

32 bit unsigned integer

Total number of IP addresses in the Network

carriers

Array of <Carrier> objects

List of Autonomous Systems (AS) announcing this network on BGP

viaCarriers

Array of <Carrier> objects

List of Autonomous Systems (AS) detected at the last hop before the announced parties

Subnet object

Field

Data type

Description

startAddress

string

First IPv4 address of the subnet. In string format

endAddress

string

Last IPv4 address of the subnet. In string format

IsCellular

boolean

Indicates ‘true’ if the subnetwork was positively detected as servicing cellular network clients, omitted otherwise

organisation

string

Registered for

registeredCountry

string

Registered Country ISO 3166-1 Alpha-2 code

registeredCountryName

string

Registered Country name localised to the language as defined by ‘localityLanguage’ request parameter

Carrier object

Field

Data type

Description

asn

string

Autonomous System Number string

asnNumeric

32 bit unsigned integer

Autonomous System Number

organisation

string

Registered Organisation

name

string

Registered name

registry

string

The Regional Internet Registry (RIR) the AS is registered with

registeredCountry

string

Registered Country ISO 3166-1 Alpha-2 code

registeredCountryName

string

Registered Country localised name. The language is as defined by 'localityLanguage' request parameter

registrationDate

string

Registration date in “yyyy-mm-dd” format

registrationLastChange

string

Registration modification date in “yyyy-mm-dd” format

totalIpv4Addresses

32 bit unsigned integer

Total number of IP addresses announced by the AS

totalIpv4Prefixes

32 bit unsigned integer

Total number of BGP prefixes announced by the AS

totalIpv4BogonPrefixes

32 bit unsigned integer

Total number of bogon prefixes announced by the AS

rank

32 bit unsigned integer

World rank by total number of IP addresses announced

rankText

string

World rank by total number of IP addresses announced including total

CarrierShort object

Field

Data type

Description

asn

string

Autonomous System Number string

asnNumeric

32 bit unsigned integer

Autonomous System Number

organisation

string

Registered Organisation

name

string

Registered name

registry

string

The Regional Internet Registry (RIR) the AS is registered with

registeredCountry

string

Registered Country ISO 3166-1 Alpha-2 code

registeredCountryName

string

Registered Country localised name. The language is as defined by ‘localityLanguage’ request parameter

rank

32 bit unsigned integer

World rank by total number of IP addresses announced

 

Range/Network object

Field

Data type

Description

Range

Network

cidr

string

CIDR range to represent the range/network

X

X

type

string

Object type. Possible values: network, range

X

X

isBogon

boolean

Indicates if the network in bogon

 

X

carriers

Array of <Carrier short> objects

List of Autonomous Systems (AS) announcing this network on BGP

 

X

deepCount

32 bit integer

Indicates how many range or network objects are located downstream to the CIDR 

X

 

totalAnnounced

32 bit unsigned integer

Indicates of how many IPv4 addresses in total has been announced within this CIDR

X

 

size

32 bit unsigned integer

Total size of the CIDR in IPv4 addresses

X

 

bogonsCount

32 bit unsigned integer

Indicates of how many IPv4 addresses has been announced within this CIDR at a bogon address space

X

 

subnets

Array of <Range/Network> objects

Array of the child Range/Network objects

X

 

Related APIs

  1. Network by IP Address API
    FREE 10,000 queries/month
    Additional 10,000 queries
    US$1.00
    /month

    Returns detailed information about the active network an IP address belongs to

    • Registration data
    • BGP prefix data
    • Carrier ASN data
    Read More
  2. BGP IPv4 Active Prefixes API
    FREE 10,000 queries/month
    Additional 10,000 queries
    US$1.00
    /month

    Returns IPv4 address space routes/prefixes which are currently announced on BGP

    • Registration status
    • Filter by Bogons
    • Filter by ASN
    • Carrier ASN data
    Read More

Sidebar