Network by IP Address API | BigDataCloud

JavaScript seems to be disabled in your browser. For the best experience on our site, be sure to turn on Javascript in your browser.

Introduction

This API returns detailed information about the active network a specific IP address belongs to. Including Autonomous Systems (AS) that announce and serve that network.

Update Rate

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

Try It Now

Use the form below to try out this API.

Parameters

Parameter	Type	Your Input Value
ip	string
key	string	Don't have an API Key? Click here to register and get your free API Key If you already have a BigDataCloud account, you can log in to automatically fill this field with your Api Key.

Curl

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

Request URL

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

Response

Awaiting request submission...

API Pricing

Monthly Subscription

FREE 10,000 queries/month

Additional 10,000 queries US$1.00/month

Add To My Subscription
Annual Subscription

FREE 10,000 queries/month

Additional 10,000 queries US$0.80/month

Add To My Subscription

API Endpoint

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

Request Format

Order	Parameter	Required	Data type	Description
1	ip	No	string	IPv4 IP address in a string or numeric format. If omitted, the caller’s IP address is assumed
2	key	Yes	string	Your API key

Response Format

Field	Data type	Description
ip	string	Requested IPv4 IP address in a string format
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 ISO 3166-1 name
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 <CarrierShort> objects	List of Autonomous Systems (AS) detected at the last hop before the announced parties

Data Objects

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 ISO 3166-1 name
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 ISO 3166-1 name
rank	32 bit unsigned integer	World rank by total number of IP addresses announced

Related APIs