IP Address Geolocation with Confidence Area and Hazard Report API

Introduction

Our IP Address Geolocation with Confidence Area and Hazard Report API offers businesses a comprehensive cybersecurity solution that includes both reactive and proactive approaches to combat cyber threats.

The API is built upon the same data and accuracy as our IP Geolocation with Confidence Area API, but with the added benefit of our innovative Hazard Report. Our Hazard Report is a unique cybersecurity metrics set that provides businesses with the tools to identify and mitigate potential threats.

With the IP Address Geolocation with Confidence Area and Hazard Report API, businesses can take proactive steps to mitigate potential threats, protecting themselves and their customers from the devastating effects of cyber attacks. To learn more about how our Hazard Report is prepared, please refer to our Understanding the Hazard Report support article page.

Get Started

This API is part of the IP Geolocation API Package and is available in free and paid plans. Please visit the IP Geolocation API Package package page for limits and pricing information.

Endpoints

IPv4 only API Endpoint

Use this endpoint to force API calls routed over the IPv4 network only

GET
https://api.bigdatacloud.net/data/ip-geolocation-full

Dual-Stack API Endpoint

This endpoint has native IPv6 support and backs the API calls routed over both IPv4 and IPv6 networks

GET
https://api-bdc.net/data/ip-geolocation-full

Request

Parameter
ip
Type
string
Required
Optional, default value: [Caller's IP]
Description
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
Parameter
localityLanguage
Type
string
Required
Optional, default value: en
Description
Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. If the requested language is unavailable for a requested location, it will default to English. If no English variant is available, will provide the native, local names. Use 'default' as the requested value to automatically adjust the language to the first administrative language in the Country.
Parameter
key
Type
string
Required
Yes
Description
Your API key

Responses

200
Success

Sample Query

GET
https://api-bdc.net/data/ip-geolocation-full?ip=3.93.173.205&localityLanguage=en&key=[YOUR API KEY]

Schema

application/json
ipstring
Requested IP address in a string format.
localityLanguageRequestedstring
localityLanguage input parameter received
isReachableGloballyboolean
Indicated whether the IP address is present on the global routing table, hence reachable. If not reachable, the IP address is not in use and therefore cannot be geolocated
country
country object
isoAlpha2string
ISO 3166-1 Alpha-2 code
isoAlpha3string
ISO 3166-1 Alpha-3 code
m49Codeinteger
United Nations M.49 code
namestring
Country name localised to the language as defined by 'localityLanguage' request parameter
isoNamestring
ISO 3166-1 Country name short
isoNameFullstring
ISO 3166-1 Country name full
isoAdminLanguagesarray
Administrative languages as defined by ISO 3166-1 standard
isoAlpha3string
ISO 3166-1 Alpha-3 code
isoAlpha2string
ISO 3166-1 Alpha-2 code
isoNamestring
ISO 3166-1 Language name
nativeNamestring
A native name
unRegionstring
Region name as defined by the United Nations
currency
currency object
numericCodeinteger
ISO 4217 standard numeric code
codestring
ISO 4217 standard code
namestring
ISO 4217 English name
minorUnitsinteger
ISO 4217 minor units as the currency exponent (e.g. 2 = 1/100)
wbRegion
wbRegion object
idstring
world bank identification number. the expected values are: 'LCN','NA','SAS','SSF','ECS','MEA','EAS','NAC'
iso2Codestring
iso 2 letters code. the expected values are: 'ZJ','NA','8S','ZG','Z7','ZQ','Z4','XU'
valuestring
region name. the expected values are: 'Latin America & Caribbean','Aggregates','South Asia', 'Sub-Saharan Africa','Europe & Central Asia','Middle East & North Africa','East Asia & Pacific','North America'
wbIncomeLevel
wbIncomeLevel object
idstring
world bank identification number. the expected values are: 'HIC','NA','LIC','LMC','UMC','INX'
iso2Codestring
iso 2 letters code. the expected values are: 'XD','NA','XM','XN','XT','XY'
valuestring
income level name. the expected values are: 'High income','Aggregates','Low income','Lower middle income','Upper middle income','Not classified'
callingCodestring
Calling code
countryFlagEmojistring
Country emoji
wikidataIdstring
Wikidata item identifier, if available
geonameIdinteger
A unique identifier as is given by GeoNames.org
isIndependentboolean
Determines if the country/territory is independent according to ISO 3166 records
location
location object
principalSubdivisionstring
Localised principal subdivision name in the requested language, if available
isoPrincipalSubdivisionstring
Principal subdivision name as defined by ISO 3166-2 standard
isoPrincipalSubdivisionCodestring
Principal subdivision code as defined by ISO 3166-2 standard
continentstring
Localised Continent name in the requested language, if available
continentCodestring
Continent code
citystring
The most significant populated place this location belongs. It will likely be the City name in the language requested. If unavailable, use the locality name field as a failover
localityNamestring
Represents the smallest geographic area recognised to which the target belongs. The language, if available, is as defined by the 'localityLanguage' request parameter
postcodestring
Postcode, if available
latitudenumber
Estimated Latitude
longitudenumber
Estimated Longitude
plusCodestring
Open Location Code
fips
FIPS code object, omitted if unavailable. FIPS (Federal Information Processing Standards) Codes are codes used by the Census Bureau to uniquely identify places in the US. Visit FIPS FAQ page for more information.
statestring
State-level FIPS codes have two digits
countystring
A three digits County-level FIPS code.
countySubdivisionstring
FIPS five digits County Subdivision Code
placestring
FIPS five digits place code, omitted if unavailable
csdCodestring
CSD (Census Subdivision) code, omitted if unavailable. Canadian Geographic Codes. Visit CSD FAQ page for more information.
timeZone
timeZone object
ianaTimeIdstring
Time Zone name in IANA format
displayNamestring
Display name
effectiveTimeZoneFullstring
Effective time zone full name (adjusted to the daylight saving status)
effectiveTimeZoneShortstring
Effective time zone short name (adjusted to the daylight saving status)
utcOffsetSecondsinteger
Effective offset from UTC time in seconds
utcOffsetstring
Effective offset from UTC time
isDaylightSavingTimeboolean
Indicates if the daylight saving is on
localTimestring
Local time in ISO 8601 format
utcTimestring
UTC time in ISO 8601 format. Omitted when utcReference parameter was not supplied, or invalid
localityInfo
localityInfo object
administrativearray
Administrative authorities as ordered by area (most significant first). Omitted if no administrative boundaries are available
namestring
Localised name of the place in the requested language, if available. The language is as defined by the 'localityLanguage' request parameter
descriptionstring
Localised description of the place in the requested language, if available. The language is as defined by the 'localityLanguage' request parameter
isoNamestring
ISO 3166-2 standard name, if available
orderinteger
Order value consistent across all entities in the Locality Info parent object. Ordered by geographic area (most significant first)
adminLevelinteger
An administrative level as defined by OpenStreetMaps project
isoCodestring
ISO 3166-2 standard code, if available
wikidataIdstring
Wikidata item identifier, if available
geonameIdinteger
Unique identifier given by GeoNames.org, if available
chinaAdminCodestring
China Administrative division code. Only available for locations based in China and omitted for others
informativearray
Non-administrative boundaries as ordered by area (most significant first). Omitted if unavailable
namestring
Localised name of the place in the requested language, if available. The language is as defined by the 'localityLanguage' request parameter
descriptionstring
Localised description of the place in the requested language, if available. The language is as defined by the 'localityLanguage' request parameter
isoNamestring
ISO 3166-2 standard name, if available
orderinteger
Order value consistent across all entities in the Locality Info parent object. Ordered by geographic area (most significant first)
adminLevelinteger
An administrative level as defined by OpenStreetMaps project
isoCodestring
ISO 3166-2 standard code, if available
wikidataIdstring
Wikidata item identifier, if available
geonameIdinteger
Unique identifier given by GeoNames.org, if available
chinaAdminCodestring
China Administrative division code. Only available for locations based in China and omitted for others
lastUpdatedstring
Indicates the time of when that particular IP address’s geolocation was assessed the last
network
network object
registrystring
The Regional Internet Registry (RIR), the network registered with
registryStatusstring
Registration status
registeredCountrystring
Registered Country ISO 3166-1 Alpha-2 code
registeredCountryNamestring
Registered Country name localised to the language is as defined by 'localityLanguage' request parameter
organisationstring
organisation or a segment the network is registered for
isReachableGloballyboolean
Indicates whether the network was announced on BGP and reachable globally or not
isBogonboolean
Indicates whether the IP address is excluded from public Internet use by the authorities but announced into the global routing table via BGP
bgpPrefixstring
The BGP prefix detected on the global network, announcing the network
bgpPrefixNetworkAddressstring
BGP prefix network (the first) address
bgpPrefixLastAddressstring
BGP prefix last address
totalAddressesstring
Total number of IP addresses in the Network
carriersarray
List of Autonomous Systems (AS) announcing this network on BGP
asnstring
Autonomous System Number string
asnNumericinteger
Autonomous System Number
organisationstring
Registered Organisation
namestring
Registered name
registrystring
The Regional Internet Registry (RIR) the AS is registered with
registeredCountrystring
Registered Country ISO 3166-1 Alpha-2 code
registeredCountryNamestring
Registered Country localised name. The language is as defined by the 'localityLanguage' request parameter
registrationDatestring
Registration date in 'yyyy-mm-dd' format
registrationLastChangestring
Registration modification date in 'yyyy-mm-dd' format
totalIpv4Addressesinteger
Total number of IP addresses announced by the AS
totalIpv4Prefixesinteger
Total number of ipV4 BGP prefixes announced by the AS
totalIpv4BogonPrefixesinteger
Total number of ipV4 bogon prefixes announced by the AS
totalIpv6Prefixesinteger
Total number of ipV6 BGP prefixes announced by the AS
totalIpv6BogonPrefixesinteger
Total number of ipV6 bogon prefixes announced by the AS
rankinteger
Global rank by total number of IP addresses announced
rankTextstring
Global rank by total number of IP addresses announced including total
viaCarriersarray
List of Autonomous Systems (AS) detected at the last hop before the announced parties. Capped to the most significant 5.
asnstring
Autonomous System Number string
asnNumericinteger
Autonomous System Number
organisationstring
Registered Organisation
namestring
Registered name
registrystring
The Regional Internet Registry (RIR) the AS is registered with
registeredCountrystring
Registered Country ISO 3166-1 Alpha-2 code
registeredCountryNamestring
Registered Country localised name. The language is as defined by the 'localityLanguage' request parameter
totalIpv4Addressesinteger
Total number of IP addresses announced by the AS
rankinteger
Global rank by total number of IP addresses announced
rankTextstring
Global rank by total number of IP addresses announced including total
confidencestring
Geolocation confidence. Possible values: 'low', 'moderate', 'high'
confidenceAreaarray
Closed polygon representing estimated geolocation confidence area
latitudenumber
Latitude in in EPSG:4326 projection, as used in GPS
longitudenumber
Longitude in EPSG:4326 projection, as used in GPS
securityThreatstring
A textual summary of an estimated security threat associated with the IP address
hazardReport
hazardReport object
isKnownAsTorServerboolean
Determines whether the requested ip address is known as utilised by a TOR server
isKnownAsVpnboolean
Determines whether the requested ip address is known as utilised by a VPN server
isKnownAsProxyboolean
Determines whether the requested ip address is known as utilised by a proxy server
isSpamhausDropboolean
Determines whether the requested ip address is listed on the spamhause drop all traffic list. The spamhaus drop (don't route or peer) lists are advisory 'drop all traffic' lists, consisting of netblocks that are 'hijacked' or leased by professional spam or cyber-crime operations (used for dissemination of malware, trojan downloaders, botnet controllers)
isSpamhausEdropboolean
Determines whether the requested ip address is listed on the spamhause edrop list According to spamhaus, edrop is an extension of the drop list that includes sub-allocated netblocks controlled by spammers or cyber criminals
isSpamhausAsnDropboolean
determines whether the requested ip address is listed on the spamhause asn-drop list. According to spamhaus, asn-drop contains a list of autonomous system numbers controlled by spammers or cyber criminals, as well as hijacked asns
isBlacklistedUceprotectboolean
Determines whether the requested ip address is blacklisted at uceprotect.net or backscatterer.org
isBlacklistedBlocklistDeboolean
Determines whether the requested ip address is blacklisted at blocklist.de
isKnownAsMailServerboolean
Determines whether the requested ip address is known as utilised by an SMTP mail server
mailServerDomainstring
The last detected SMTP domain name making use of this ip address
isKnownAsPublicRouterboolean
Determines whether the requested ip address is known as utilised by a public router
isBogonboolean
Indicates whether the IP address is excluded from public Internet use by the authorities but announced into the global routing table via BGP
isUnreachableboolean
Determines whether the requested ip address is not reachable via the public Internet
hostingLikelihoodinteger
The likelihood 0-10 of a hosting origin
isHostingAsnboolean
Determines whether the requested ip address was announced by an autonomous system which is likely to publish hosting networks
isCellularboolean
Determines whether the requested ip address was detected as utilised within a cellular network
iCloudPrivateRelayboolean
Determines whether the requested ip address was detected as Apple iCloud Private Relay address

Sample Response

JSON View
403
Access denied, or your quota limit has exceeded

Sample Response

JSON View
404
Found no valid entry for the request

Sample Response

JSON View
405
The requested IP address is not valid

Sample Response

JSON View
500
An error has occurred and did not complete your request. Please try again

Sample Response

JSON View
Was this page helpful?