Network by IP Address API
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.
GET
https://api-bdc.net/data/network-by-ipParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
ip | string | Optional | IPv4 IP address in a string or numeric format or IPv6 IP address in a string format. If omitted, the caller’s IP address is assumed |
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 |
key | string | Optional | Your API key |
Responses
200OK
Sample Request
https://api-bdc.net/data/network-by-ip?ip=3.236.144.198&localityLanguage=en&key=[YOUR API KEY]Sample Response
JSON View
Response Schema
ipstringRequested IP address in a string format
registrystringThe Regional Internet Registry (RIR), the network registered with
registryStatusstringRegistration status
registeredCountrystringRegistered Country ISO 3166-1 Alpha-2 code
registeredCountryNamestringRegistered Country name localised to the language is as defined by 'localityLanguage' request parameter
organisationstringorganisation or a segment the network is registered for
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
bgpPrefixNetworkAddressstringBGP prefix network (the first) address
bgpPrefixLastAddressstringBGP prefix last address
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
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
registrationDatestringRegistration date in 'yyyy-mm-dd' format
registrationLastChangestringRegistration modification date in 'yyyy-mm-dd' format
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
rankTextstringGlobal rank by total number of IP addresses announced including total
▶viaCarriersarrayList of Autonomous Systems (AS) detected at the last hop before the announced parties. Capped to the most significant 5.
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
403Access denied, or your quota limit has exceeded
Sample Response
JSON View
404Found no valid entry for the request
Sample Response
JSON View
405The requested IP address is not valid
Sample Response
JSON View
500An error has occurred and did not complete your request. Please try again
Sample Response
JSON View