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