Response Fields

A description of every field returned by the ipdata API.

Field
Description
ip
The IP address that was looked up.
is_eu
Returns 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.
count
The total number of requests made by your API key in the last 24 hrs. Updates once a minute.
city
The name of the city from where the IP Address is located.
region
The name of the region where the IP Address is located.
region_code
The 3 letter ISO 3166-2 code for the region.
country_name
The name of the country where the IP Address is located.
country_code
The 2 letter ISO 3166-1 alpha-2 code for the country.
continent_name
The name of the continent where the IP Address is located. One of; Africa, Antarctica, Asia, Europe, North America, Oceania, Solanguuth America
continent_code
The 2 letter ISO 3166-1 alpha-2 code for the continent. One of; AF, AN, AS, EU, NA, OC, SA
latitude
An approximate latitudinal location for the IP Address. Often near the center of population.
longitude
An approximate longitudinal location for the IP Address. Often near the center of population.
asn
The Autonomous System Number that references the IP Address's owning organization.
organisation
The name of the Organisation that owns the IP Address. This will default to the ISP is the name of the organisation is not available.
postal
The Postal code for where the IP Address is located.
calling_code
The International Calling Code for the country where the IP Address is located.
flag
A link to a PNG file with the flag of the country where the IP Address is located.
emoji_flag
An emoji version of the flag of the country where the IP Address is located.
emoji_unicode
The Unicode for the emoji flag.
carrier
A JSON object with details of the IP Addresses's carrier.
carrier->name
The name of the carrier that owns the IP Address.
carrier->mcc
The Mobile Country Code of the carrier.
carrier->mnc
The Mobile Network Code that identifies the carrier.
languages
A JSON list of individual language objects.
languages->name
The name of the language in English
languages -> native
The Native name of the language.
currency
A JSON object with details of the IP Address country's main currency.
currency->name
The name of the currency.
currency->code
The ISO 4217 currency code.
currency->symbol
The symbol of the currency.
currency->native
The native symbol of the currency.
currency->plural
The plural version of the currency. For example; US dollars, Australian dollars, Euros
time_zone
A JSON object with details of the Timezone the IP Address belongs to.
time_zone->name
The name of the Timezone Eg. "America/Los_Angeles"
time_zone->abbr
The Abbreviation of the Timezone Eg. "PDT"
time_zone->offset
The UTC offset of the Timezone Eg. "-0700"
time_zone -> is_dst
true or false depending on whether or not Daylight Savings have been accounted for.
time_zone -> current_time
The exact current time in the Timezone the IP Address belongs to accounting for Daylight Savings.
threat
A JSON object representing the threat intelligence profile of the IP Address.
threat -> is_tor
true or false depending on whether the IP Address is a known Tor exit node or relay.
threat -> is_proxy
true or false depending on whether the IP Address is a known proxy or any type.
threat -> is_anonymous
true or false depending on whether is_tor or is_proxy is true.
threat -> is_known_attacker
true or false if the IP Address is a known (reported) source of malicious activity.
threat -> is_known_abuser
true or false if the IP Address is a known (reported) source of abuse.
threat -> is_threat
true or false depending on whether is_known_abuser or is_known_attacker is true.
threat -> is_bogon
true or false if the IP Address is a Bogon i.e. an unassigned, unaddressable IP address

API Reference - Previous

Securing your API Key

Next - API Reference

Status Codes

Last updated Wed Mar 27 2019 10:29:07 GMT+0000 (UTC)

Field	Description
ip	The IP address that was looked up.
is_eu	Returns `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.
count	The total number of requests made by your API key in the last 24 hrs. Updates once a minute.
city	The name of the city from where the IP Address is located.
region	The name of the region where the IP Address is located.
region_code	The 3 letter ISO 3166-2 code for the region.
country_name	The name of the country where the IP Address is located.
country_code	The 2 letter ISO 3166-1 alpha-2 code for the country.
continent_name	The name of the continent where the IP Address is located. One of; Africa, Antarctica, Asia, Europe, North America, Oceania, Solanguuth America
continent_code	The 2 letter ISO 3166-1 alpha-2 code for the continent. One of; AF, AN, AS, EU, NA, OC, SA
latitude	An approximate latitudinal location for the IP Address. Often near the center of population.
longitude	An approximate longitudinal location for the IP Address. Often near the center of population.
asn	The Autonomous System Number that references the IP Address's owning organization.
organisation	The name of the Organisation that owns the IP Address. This will default to the ISP is the name of the organisation is not available.
postal	The Postal code for where the IP Address is located.
calling_code	The International Calling Code for the country where the IP Address is located.
flag	A link to a PNG file with the flag of the country where the IP Address is located.
emoji_flag	An emoji version of the flag of the country where the IP Address is located.
emoji_unicode	The Unicode for the emoji flag.
carrier	A JSON object with details of the IP Addresses's carrier.
carrier->name	The name of the carrier that owns the IP Address.
carrier->mcc	The Mobile Country Code of the carrier.
carrier->mnc	The Mobile Network Code that identifies the carrier.
languages	A JSON list of individual language objects.
languages->name	The name of the language in English
languages -> native	The Native name of the language.
currency	A JSON object with details of the IP Address country's main currency.
currency->name	The name of the currency.
currency->code	The ISO 4217 currency code.
currency->symbol	The symbol of the currency.
currency->native	The native symbol of the currency.
currency->plural	The plural version of the currency. For example; US dollars, Australian dollars, Euros
time_zone	A JSON object with details of the Timezone the IP Address belongs to.
time_zone->name	The name of the Timezone Eg. "America/Los_Angeles"
time_zone->abbr	The Abbreviation of the Timezone Eg. "PDT"
time_zone->offset	The UTC offset of the Timezone Eg. "-0700"
time_zone -> is_dst	`true` or `false` depending on whether or not Daylight Savings have been accounted for.
time_zone -> current_time	The exact current time in the Timezone the IP Address belongs to accounting for Daylight Savings.
threat	A JSON object representing the threat intelligence profile of the IP Address.
threat -> is_tor	`true` or `false` depending on whether the IP Address is a known Tor exit node or relay.
threat -> is_proxy	`true` or `false` depending on whether the IP Address is a known proxy or any type.
threat -> is_anonymous	`true` or `false` depending on whether is_tor or is_proxy is true.
threat -> is_known_attacker	`true` or `false` if the IP Address is a known (reported) source of malicious activity.
threat -> is_known_abuser	`true` or `false` if the IP Address is a known (reported) source of abuse.
threat -> is_threat	`true` or `false` depending on whether is_known_abuser or is_known_attacker is true.
threat -> is_bogon	`true` or `false` if the IP Address is a Bogon i.e. an unassigned, unaddressable IP address