All Response Fields
Documentation

All Response Fields

Geolocation

FieldDescription
ipThe IP address that was looked up.
is_euReturns true or false depending on whether the country is a recognized member of the European Union. The list of all EU countries is compiled from this list on the European Union website.
countThe total number of requests made by your API key in the last 24 hrs. Updates once a minute.
cityThe name of the city from where the IP Address is located.
regionThe name of the region where the IP Address is located.
region_codeThe ISO 3166-2 code for the region.
region_typeThe given region can either be a first or second level administrative subdivision, this field tells you what type it is. For example in the US the region is usually a state, Canada has provinces etc
country_nameThe name of the country where the IP Address is located.
country_codeThe 2 letter ISO 3166-1 alpha-2 code for the country.
continent_nameThe name of the continent where the IP Address is located. One of; Africa, Antarctica, Asia, Europe, North America, Oceania, South America
continent_codeThe 2 letter ISO 3166-1 alpha-2 code for the continent. One of; AF, AN, AS, EU, NA, OC, SA
latitudeAn approximate latitudinal location for the IP Address. Often near the center of population.
longitudeAn approximate longitudinal location for the IP Address. Often near the center of population.
postalThe Postal code for where the IP Address is located.
calling_codeThe International Calling Code for the country where the IP Address is located.
flagA link to a PNG/SVG file with the flag of the country where the IP Address is located. To pick your format set the extension you want eg. https://ipdata.co/flags/us.png for PNG or https://ipdata.co/flags/us.svg for SVG.
emoji_flagAn emoji version of the flag of the country where the IP Address is located.
emoji_unicodeThe Unicode for the emoji flag.

Mobile Carrier

FieldDescription
nameThe name of the carrier that owns the IP Address
mccThe Mobile Country Code of the carrier
mncThe Mobile Network Code that identifies the carrier

Timezone Data

FieldDescription
nameThe name of the Timezone
abbrThe abbreviation of the Timezone
offsetThe UTC offset of the Timezone
is_dsttrue or false depending on whether or not Daylight Savings have been accounted for
current_timeThe exact current time in the Timezone the IP Address belongs to adjusted for Daylight Savings

Currency

nameThe singular name of the currency
codeThe ISO 4217 currency code
symbolThe symbol of the currency
nativeThe native symbol of the currency
pluralThe plural version of the currency. For example; US dollars, Australian dollars, Euros

Threat Intelligence

FieldDescription
is_toris true if the IP address is associated with a node on the Tor network
is_vpntrue for VPN IP addresses. There are approx. 2.6M IP addresses updated daily. This is available to Business and Enterprise users only.
is_icloud_relaytrue for IP addresses belonging to Apple's iCloud relay service
is_proxyis true if the IP address is a known proxy, includes HTTP/HTTPS/SSL/SOCKS/CONNECT and transparent proxies
is_datacentertrue for any IP addresses that belong to a datacenter including all cloud providers. Can be useful for detecting automated/bot traffic.
is_anonymousis set true if either one of is_tor or is_proxy is true
is_known_attackeris true if an IP address is a known source of malicious activity, i.e. attacks, malware, botnet activity etc
is_known_abuseris true if the IP address is a known source of abuse i.e. spam, harvesters, registration bots and other nuisance bots etc
is_threatis true if either one of is_known_abuser or is_known_attacker is true
is_bogontrue for if an IP address is a bogon.
blocklistsAn array of blocklists an IP address has been reported to. It includes the name, website and list type.
scoresA map of IP reputation scores.

Usage Type

There are several options for usage type

FieldDescription
hostingBelonging to a datacenter (we have mapped 200M+ hosting IP addresses)
ispBelonging to ISP IP space (we have mapped 1B+ isp IPs)
cdnBelonging to a Content delivery network
eduEducational institutions
govOne of ~25,000 government agencies worldwide
milMilitary organizations
businessEnd-user organizations

Basic ASN Data

FieldDescription
asnThe Autonomous System Number
nameThe name of the organization that owns the ASN
domainThe website of the organization
routeThe network prefix the IP Address belongs to
typeThe usage type associated with the IP Address and ASN

Advanced ASN Data

FieldDescription
domainThe website of the organization
usageUsage Type (same categories as ASN)
nameThe name of the organization that owns the ASN
ipv4_prefixesThe ipv4 network prefixes associated with the ASN
ipv6_prefixesThe ipv6 network prefixes associated with the ASN
num_ipsThe number of IP addresses associated with the ASN
registryRegistry/Administrator of the ASN
countryCountry associated with the ASN
dateDate ASN was assigned
statusASN status
upstreamUpstream providers for the ASN in question
downstreamDownstream ASN providers for the ASN in question
peersPeer ASN providers for the ASN in question

Company data

FieldDescription
nameThe name of the end-user organization the network has been assigned to.
domainThe website of the organization.
networkThe network prefix assigned to the organization.
typeThe usage type associated with the IP Address and Company