Filtering Response Fields
You can choose to request only a single field to be returned in the API response or to get multiple fields pass a "fields" query parameter with the names of the specific fields you need.
Selecting Multiple Fields
Looking up the location and mobile carrier information associated with an IP Address
curl 'https://api.ipdata.co/69.78.70.144?api-key=<<apiKey>>&fields=ip,city,region,country_name,continent_name,carrier'
Sample Response
{
"ip": "69.78.70.144",
"city": "Farmersville",
"region": "Texas",
"country_name": "United States",
"continent_name": "North America",
"carrier": {
"name": "Verizon",
"mcc": "310",
"mnc": "004"
}
}
Selecting a Single Field
Looking up the calling IP's country name
curl https://api.ipdata.co/country_name?api-key=<<apiKey>>
Looking up a specific IP's country name
curl https://api.ipdata.co/3.3.3.3/country_name?api-key=<<apiKey>>
Sample Response
United States
The available fields are;
- ip
- is_eu
- city
- region
- region_code
- country_name
- country_code
- continent_name
- continent_code
- latitude
- longitude
- asn
- company
- postal
- calling_code
- flag
- emoji_flag
- emoji_unicode
- carrier
- languages
- currency
- time_zone
- threat
- count
For a description of every field see Our Data Table.
Updated over 2 years ago