IP Location Module

IP to Location module provides geolocation information related to an IP address such as continent, country, country capital, state/province, city, locality, accuracy radius, zip code, DMA code, country flag, latitude and longitude information.

Response

"location": {
  "continent_code": "NA",
  "continent_name": "North America",
  "country_code2": "US",
  "country_code3": "USA",
  "country_name": "United States",
  "country_name_official": "United States of America",
  "country_capital": "Washington, D.C.",
  "state_prov": "California",
  "state_code": "US-CA",
  "district": "Santa Clara",
  "city": "Mountain View",
  "locality": "Mountain View",
  "accuracy_radius": "5",
  "dma_code": "807",
  "zipcode": "94043-1351",
  "latitude": "37.42240",
  "longitude": "-122.08421",
  "is_eu": false,
  "country_flag": "https://ipgeolocation.io/static/flags/us_64.png",
  "geoname_id": "6301403",
  "country_emoji": "🇺🇸"
}

Country Metadata Module

Country metadata module provides country calling (dialing) code, country's top level domain name (ccTLD) and official spoken languages in the country associated with the queried IP address.

Response

"country_metadata": {
  "calling_code": "+1",
  "tld": ".us",
  "languages": [
    "en-US",
    "es-US",
    "haw",
    "fr"
  ]
}

Network Module

Network information module provides network related information such as ASN details including AS number, organization name, country where the ASN is registered, type of ASN, Regional Internet Registry (RIR), number of IPv4 and IPv6 routes, and allocation status.

It also includes company details such as the name of the company to whom the IP address is further licensed by the ISP, its type, and domain name, along with the connection type (wired or wireless).

Response

"network": {
  "asn": {
    "as_number": "15169",
    "organization": "Google LLC",
    "country": "US",
    "asn_name": "GOOGLE",
    "type": "isp",
    "domain": "about.google",
    "date_allocated": "1997-09-15",
    "allocation_status": "Assigned",
    "num_of_ipv4_routes": "1099",
    "num_of_ipv6_routes": "107",
    "rir": "ARIN"
  },
  "company": {
    "name": "Google LLC",
    "type": "hosting",
    "domain": "google.com"
  },
  "connection_type": "wired"
}

Currency Module

IP to Currency module provides currency information of the country such as currency name, currency symbol and currency code from an IP address.

Response

"currency": {
  "name": "US Dollar",
  "code": "USD",
  "symbol": "$"
}

Security Module

The security module provides threat intelligence data such as threat score, is tor, vpn or proxy, proxy provider name, is known attacker, and if the IP address belongs to one of the cloud providers.

Response

"security": {
  "threat_score": 80,
  "is_tor": false,
  "is_proxy": true,
  "proxy_type": "VPN",
  "proxy_provider": "proton",
  "is_anonymous": true,
  "is_known_attacker": true,
  "is_spam": false,
  "is_bot": false,
  "is_cloud_provider": false,
  "cloud_provider": ""
}

Abuse Contact Module

The Abuse Module provides contact details of the responsible party for the queried IP address, including country, organization, email address and phone number. Ideal for reporting malicious activity or handling abuse complaints.

Response

"abuse": {
  "route": "78.8.0.0/14",
  "country": "PL",
  "handle": "NT1264-RIPE",
  "name": "Netia Telekom S.A.",
  "organization": "Netia Telekom S.A.",
  "role": "abuse",
  "kind": "group",
  "address": "Poleczki 13\n02-822 Warszawa\nPoland",
  "emails": [
    "abuse@inetia.pl"
  ],
  "phone_numbers": [
    "+48(22)352 2213",
    "+48(22)352 0000"
  ]
}

Time Zone Module

IP to Time Zone module provides time and timezone related information such as timezone name, UTC/GMT offset, current date and time, daylight saving time status, daylight saving offset in hours, along with start and end details of daylight saving time.

Response

"time_zone": {
  "name": "America/Los_Angeles",
  "offset": -8,
  "offset_with_dst": -7,
  "current_time": "2024-10-02 00:06:41.301-0700",
  "current_time_unix": 1727852801.301,
  "is_dst": true,
  "dst_savings": 1,
  "dst_exists": true,
  "dst_start": {
    "utc_time": "2024-03-10 TIME 10",
    "duration": "+1H",
    "gap": true,
    "dateTimeAfter": "2024-03-10 TIME 03",
    "dateTimeBefore": "2024-03-10 TIME 02",
    "overlap": false
  },
  "dst_end": {
    "utc_time": "2024-11-03 TIME 09",
    "duration": "-1H",
    "gap": false,
    "dateTimeAfter": "2024-11-03 TIME 01",
    "dateTimeBefore": "2024-11-03 TIME 02",
    "overlap": true
  }
}

User Agent Parser Module

User Agent module parses the browser user agent string and provides detailed device information such as device name, device version, device type, device operating system, device browser, browser engine and browser version. It can identify robots, crawlers and attackers.

Response

"user_agent": {
  "userAgentString": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_3) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.0.5 Safari/605.1.15",
  "name": "Safari",
  "type": "Browser",
  "version": "13.0.5",
  "versionMajor": "13",
  "device": {
    "name": "Apple Macintosh",
    "type": "Desktop",
    "brand": "Apple",
    "cpu": "Intel"
  },
  "engine": {
    "name": "AppleWebKit",
    "type": "Browser",
    "version": "605.1.15",
    "versionMajor": "605"
  },
  "operatingSystem": {
    "name": "Mac OS",
    "type": "Desktop",
    "version": "10.15.3",
    "versionMajor": "10.15"
  }
}

Reverse IP Lookup Module

With reverse IP Lookup, you can resolve the host name or domain or router dns address. This gives you detailed information about the original source of traffic.

Response

curl 'https://api.ipgeolocation.io/v2/ipgeo?include=hostname&ip=8.8.8.8&apiKey=API_KEY'

Response

{
 "ip":"8.8.8.8",
 "hostname":"dns.google",
 "..."
}

Domain IP Lookup

Enter the domain address in place of IP address and our API will perform a DNS Lookup to give you the information about the web hosting provider and the geographical location of the website.

Response

{
  "domain": "ipgeolocation.io",
  "ip": "104.20.40.71",
  "location": {
    "country_name": "United States",
    "state_prov": "California",
    "city": "San Francisco",
    "..."
  },
  "network": {
    "asn": {
      "as_number": "13335",
      "domain": "cloudflare.com"
    },
    "company": {
      "name": "Cloudflare, Inc."
    }
  }
}

Bulk IP Address Lookup Support

Use our Bulk IP Lookup endpoint to perform batch lookup of multiple IP addresses in a single request. Query up to 50,000 IPv4, IPv6 or domain names at once.

Response

curl -X POST 'https://api.ipgeolocation.io/v2/ipgeo-bulk?apiKey=API_KEY' \
 -H 'Content-Type: application/json' \
 -d '{
 "ips": ["1.1.1.1", "1.2.3.4", "1.2.3.5", "1.2.3.6", "1.2.3.7"]
 }'

Response in Multiple Languages

You can retrieve the geolocation information for an IP address in the following languages:

English

German

Russian

Japanese

French

Chinese Simplified ES Flag

Spanish

Czech

Italian

Korean

Persian

Portuguese

Use Cases

Website content localization

Adapt the content of your website to the destination of your visitors. Make your visitors feel right at home by "talking" to them in their local language and connect with them instantly. With IP geolocation, redirect your users to their region-specific websites and increase the possibility of increasing conversions up to 70%.

Non-intrusive geolocation

Do you have an awesome content localization strategy in place? IP geolocation is a non-intrusive way to know where your visitors are coming from. Don't ruin your visitor's website experience by showing annoying pop-ups asking for their location. Our geolocation API will detect their location from their IP address and show them the relevant message.

Digital Rights Protection

Enforce digital rights of your content using IP location API. Build a virtual fence around your content and make sure that only the people inside the fence can see it.

Prevent Threats and Scams

With our security and user agent module, you can identify anonymous traffic sources, known attackers, suspicious devices and tor nodes to prevent online fraud, trial abusers, forum spams and botnet attackers.

Ready to get started? Get Started with IP Intelligence API Today

Get Started

IP Geolocation API Documentation

Q: What information can I obtain using the IP Location API?

The IP Location API provides detailed geographical data based on IP addresses, including information like country, city, state, latitude, longitude, user’s time zone information, currency details, ISP, ASN, and organization name. You can also access threat intelligence, VPN/proxy status, and device data from the user-agent string.

Q: Does the IP Location API support batch IP address lookups?

Yes, the IP Location API supports batch IP address lookups, allowing you to query up to 50,000 IPs in a single request. However, this feature is available only on paid plans. The requests made in the batch will count towards your total API usage.

Q: Are there SDKs available for the IP Location API?

IPGeolocation offers SDKs for popular programming languages such as Java, Python, JavaScript, jQuery, TypeScript, C#, and PHP. These SDKs simplify the integration of the IP Location API into your projects. Additionally, detailed guides are available to assist with integrating the API and databases with Splunk.

Q: How frequently is the geolocation data updated?

Our IP Location API data updates every 24 hours. Our downloadable databases are available with weekly and monthly updates, providing you with the most up-to-date geolocation information.

Q: What security measures are in place for the IP Location API?

The IP Location API ensures data security with secure HTTPS connections for all API endpoints. Our infrastructure features globally distributed data and edge nodes, enhancing reliability and protection against DDoS attacks. Additionally, IPGeolocation complies with data protection regulations, including the General Data Protection Regulation (GDPR), to ensure user privacy and data security.

Q: What is IP Geolocation and how does it work?

IP Geolocation identifies the physical location of a device by analyzing its IP address along with data from internet registries, ISPs, network routing, and user reports. It helps determine key details such as country, state/region, city, ZIP code, ISP, and more. ipgeolocation.io combines multiple reliable data sources and frequent updates to deliver accurate, real-time location insights for both IPv4 and IPv6 addresses.

Q: How accurate is IP Geolocation data?

IP Geolocation is typically over 99% accurate at the country level and around 85% or higher at the city level, with a 20–50 km accuracy radius depending on the region and ISP. ipgeolocation.io maintains high accuracy by updating its database daily and using reliable data sources to deliver precise geolocation, along with ISP, timezone, and currency details.

Q: What can I use IP Geolocation for, in my application or website?

IP Geolocation helps personalize user experiences, display region-specific content, detect fraud, enforce compliance, and improve analytics. With ipgeolocation.io’s API, developers can easily integrate features like automatic timezone detection, localized content, and fraud prevention using security data such as is_bot, is_proxy, and more.

Q: What is an IP Geolocation API?

An IP Geolocation API allows applications to retrieve detailed location data about an IP address through simple API requests. ipgeolocation.io’s API returns data such as country, city, ISP, timezone, currency, and even detects VPN, proxy, and TOR usage, making it easy to enhance applications with location intelligence.

Q: How do I get an IP Geolocation API key?

You can get an API key by signing up for a free account at ipgeolocation.io. Once registered and logged into your dashboard, you’ll find your unique API key, which you can use to send requests to the API.

IP Geolocation API

IP Geolocation API provides real-time and accurate geolocation, network, abuse, and security information for any IPv4 or IPv6 address and domain name along with the user-agent detail for the provided user-agent string. You can geolocate your online visitors and provide them the customized user-experience accordingly.

We provide the two endpoints in our IP Lookup API to get geolocation information.

Single IP Geolocation Lookup API

Single IP Location API can be used in two ways to lookup any IP address or domain name with JSON or XML response. The URL for this endpoint is https://api.ipgeolocation.io/v2/ipgeo and its full JSON response is below:

Response

Passing an IPv4, IPv6 Address or a domain

In order to find geolocation information about an IP address or a domain name, pass it as a query parameter ip like below. Note that apiKey is also needed to be passed as a query parameter for authorization. This endpoint is meant to be called from the server side.

Passing an IPv4

Here's an example to get the geolocation information for '8.8.8.8'.

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Passing an IPv6

Here's an example to get the geolocation information for '2001:4860:4860::1'.

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

The geolocation information for an IP address from the IP Geolocation API can be retrieved in the following languages

English (en)
German (de)
Russian (ru)
Japanese (ja)
French (fr)
Chinese Simplified (cn)
Spanish (es)
Czech (cs)
Italian (it)
Korean (ko)
Persian (fa)
Portuguese (pt)

By default, the API responds in English. You can change the response language by passing the language code as a query parameter lang. Here is an example to get the geolocation data for IP adderss '1.1.1.1' in Chinese language:

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Only the paid plan subscriptions (STANDARD or ADVANCED) can get the response in languages other than English. All the other subscriptions will only get the response in English.

Filter Responses

PHP

Python

Swift

Ruby

Response

• Remove the Unnecessary Fields

Second, you can also filter the API response by excluding specific fields (except the IP address) that you don't need. To do this, pass the unwanted field names using the excludes query parameter, with each field represented as a dot-separated path. Here's an example showing how to exclude unnecessary fields:

Exclude Continent Code, Currency and, Network Objects

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Response

This URL parameter enables the IPGeolocation API to lookup hostname from our IP-Hostname database and returns the same IP address if there is no hostname found for the queried IP address. Lookup thru IP-Hostname database is faster than other options but is experimental and under process and can produce unwanted output.

`include=liveHostname` URL Parameter

This URL parameter enables the IPGeolocation API to lookup hostname from live sources. Lookup thru live sources is accurate but can introduce more latency to your query to IPGeolocation API

`include=hostnameFallbackLive` URL Parameter

This URL parameter enables the IPGeolocation API to lookup hostname from our IP-Hostname database and if there is no hostname found for the queried IP address, then lookup thru the live sources. This option has been introduced for faster and accurate lookup.

Time Zone Information for an IP Address

IP Geolocation API can also provide time zone information for an IP address on paid API plans (STANDARD and ADVANCED). However, this data is not included in the response by default. To get the time zone information along with the geolocation information, you must need to pass the include=time_zone as a query parameter in the URL.

Here is an example of an IP Geolocation lookup that includes time zone data, along with the country information associated with the IP address:

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Response

User-Agent Information for a Device

IP Geolocation API also provides User-Agent information of the client on all the paid subscriptions, but doesn't respond it by default. To get User-Agent information along with the geolocation information, you must pass the include=user_agent as a query parameter in the URL.

Here is an example to IP Geolocation lookup that includes User-Agent information for a device from which the query originated, along with city and country name associated with the IP Address:

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Response

Note: To get hostname, DMA code, IP-Security information, Abuse contact Information, Time Zone Information and user-agent information together for an IP address and the device, you can pass include=hostname, dma, security, abuse, time_zone, user_agentas a query parameter in the URL.

Reference to IPGeolocation API Response

Below, we provide separate tables for each JSON object in the response, listing all possible fields available across all plans. The fifth column indicates the minimum plan required to access each field.

Please note that field availability is cumulative: all fields available in the BASIC plan are also included in STANDARD and ADVANCED, and all STANDARD fields are also available in the ADVANCED plan.

Field	Type	Description	Can be empty?	Availability
ip	string	IP address that is used to lookup geolocation information.	No	BASIC
domain	string	Domain name that is used to lookup geolocation information. It is not returned if an IP address is used to query IP Geolocation API.	Yes	STANDARD
hostname	string	Hostname of the IP address used to query IP Geolocation API.	No	STANDARD

• `location` json object reference

Field	Type	Description	Can be empty?	Availability
continent_code	string	2-letter code of the continent.	No	BASIC
continent_name	string	Name of the continent.	No	BASIC
country_code2	string	Country code (ISO 3166-1 alpha-2) of the country.	No	BASIC
country_code3	string	Country code (ISO 3166-1 alpha-3) of the country.	No	BASIC
country_name	string	Name of the country.	No	BASIC
country_name_official	string	Official name (ISO 3166) of the country.	No	BASIC
country_capital	string	Name of the country’s capital.	No	BASIC
state_prov	string	Name of the state/province/region.	Yes	BASIC
state_code	string	Code of the state/province/region.	Yes	BASIC
district	string	Name of the district or county.	Yes	BASIC
city	string	Name of the city.	Yes	BASIC
locality	string	A more specific area in city or it can be same as city.	Yes	ADVANCED
accuracy_radius	string	Circular radius in Km, where the IP address location can be found.	Yes	ADVANCED
dma_code	string	Representing Designated Market Area (DMA) code specifically used in the United States for media marketing.	Yes	BASIC
zipcode	string	ZIP/Postal code of the place.	Yes	BASIC
latitude	string	Latitude of the place.	No	BASIC
longitude	string	Longitude of the place.	No	BASIC
is_eu	boolean	Is the country belong to European Union?	No	BASIC
country_flag	string	URL to get the country flag.	No	BASIC
geoname_id	string	Geoname ID of the place from geonames.org	Yes	BASIC
country_emoji	string	Emoji of the Country flag.	Yes	BASIC

• `country_metadata` json object reference

Field	Type	Description	Can be empty?	Availability
calling_code	string	Calling code/Dialing code of the country.	No	BASIC
tld	string	Top Level Domain Name (TLD) of the country, which is also called ccTLD.	No	BASIC
languages	list of strings	List of the languages’ codes, spoken in the country.	No	BASIC

• `network` json object reference

Field	Type	Description	Can be empty?	Availability
asn.as_number	string	Autonomous system number of the autonomous system, to which IP address belongs to.	Yes	STANDARD
asn.organization	string	Legal Full Name of AS organization holding the IP address.	Yes	STANDARD
asn.country	string	Name of the country, ASN is residing.	Yes	STANDARD
asn.asn_name	string	Name associated with the Autonomous System, usually representing organization.	Yes	ADVANCED
asn.type	string	Type of the ASN, whether ISP, Business, etc.	Yes	ADVANCED
asn.domain	string	Domain name associated with the ASN holding the IP address.	Yes	ADVANCED
asn.date_allocated	string	Last date, when the IP address assigned to the ASN. e.g., in format '1st June 2001'	Yes	ADVANCED
asn.allocation_status	string	Whether the IP address is currently assigned to the ASN or not.	Yes	ADVANCED
asn.num_of_ipv4_routes	string	Total number of IPv4 routes, held by the ASN. These Routes can be queried from our ASN API.	Yes	ADVANCED
asn.num_of_ipv6_routes	string	Total number of IPv6 routes, held by the ASN. These Routes can be queried from our ASN API.	Yes	ADVANCED
asn.rir	string	Name of the Regional Internet Registry(RIR) that allocated the AS number.	Yes	ADVANCED
company.name	string	Name of the company/ISP holding the IP address.	No	STANDARD
company.type	string	Type of the company whether is an ISP, hosting provider or business, etc.	Yes	ADVANCED
company.domain	string	Official domain name used by the company.	Yes	ADVANCED
connection_type	string	Type of the connection, consuming the IP address.	Yes	ADVANCED

• `currency` json object reference

Field	Type	Description	Can be empty?	Availability
code	string	Currency code (ISO 4217).	No	BASIC
name	string	Currency name (ISO 4217).	No	BASIC
symbol	string	Currency symbol.	No	BASIC

• `security` json object reference

Field	Type	Description	Can be empty?	Availability
threat_score	number	IP address’ threat score. It ranges from 0 to 100. 100 indicates highest threat and vice versa for lower score.	No	ADVANCED
is_tor	boolean	Indicates if the IP address is being consumed on a Tor endpoint.	No	ADVANCED
is_proxy	boolean	Indicates if the IP address belongs to a proxy network.	No	ADVANCED
proxy_type	string	Type of the proxy network if the IP address belongs to a proxy network.	Yes	ADVANCED
proxy_provider	string	Name of the proxy provider, if the IP address belongs to a proxy network.	Yes	ADVANCED
is_anonymous	boolean	Indicates if the IP address is being used anonymously.	No	ADVANCED
is_known_attacker	boolean	Indicates if the IP address is enlisted as an attacking IP address.	No	ADVANCED
is_spam	boolean	Indicates if the IP address is enlisted as a spam IP address.	No	ADVANCED
is_bot	boolean	Indicates if the IP address is enlisted as a bot IP address.	No	ADVANCED
is_cloud_provider	boolean	Indicates if the IP address belongs to a cloud provider (computing infrastructure providers).	No	ADVANCED
cloud_provider	boolean	Name of the Cloud Provider, if the IP address belongs to a cloud provider.	Yes	ADVANCED

• `abuse` json object reference

Field	Type	Description	Can be empty?	Availability
route	string	Network route associated with the IP address.	Yes	ADVANCED
country	string	Country where the responsible entity is located.	Yes	ADVANCED
handle	string	Abuse handle or ID found in WHOIS or RDAP records.	Yes	ADVANCED
name	string	Name of the abuse contact person or entity..	Yes	ADVANCED
organization	string	Organization responsible for the IP address.	Yes	ADVANCED
role	string	Role of the contact (e.g., abuse, administrative, registrant, etc.).	Yes	ADVANCED
kind	string	Type of contact: individual, team, or organization.	Yes	ADVANCED
address	string	Physical mailing address of the responsible entity..	Yes	ADVANCED
emails	list of strings	Email address(es) of the abuse contact.	Yes	ADVANCED
phone_numbers	list of strings	Phone number(s) in international format for the abuse contact.	Yes	ADVANCED

• `time_zone` json object reference

Field	Type	Description	Can be empty?	Availability
name	string	Name (ISO 8601) of the time zone.	No	STANDARD
offset	number	Time zone offset from UTC.	No	STANDARD
offset_with_dst	number	Time zone with DST offset from UTC.	No	STANDARD
current_time	string	Current time in ‘yyyy-MM-dd HH:mm:ss.SSS±ZZZ’ format.	No	STANDARD
current_time_unix	float	Current time in seconds since 1970.	No	STANDARD
is_dst	boolean	Is the time zone in daylight savings?	No	STANDARD
dst_savings	number	Total daylight savings.	No	STANDARD
dst_exists	boolean	Whether Daylight Saving Time (DST) is observed in the region.	No	STANDARD
dst_start.utc_time	string	The date and time in UTC when DST begins.	No	STANDARD
dst_start.duration	string	The time change that occurs when DST starts.	No	STANDARD
dst_start.gap	boolean	Is there a gap when the clocks jump forward or not.	No	STANDARD
dst_start.dateTimeAfter	string	The local date and time that immediately follows the start of DST.	No	STANDARD
dst_start.dateTimeBefore	string	The local date and time immediately before DST begins.	No	STANDARD
dst_start.overlap	boolean	Whether there is an overlap of time due to clocks being set back when DST starts.	No	STANDARD
dst_end.utc_time	string	The date and time in UTC when DST ends.	No	STANDARD
dst_end.duration	string	The time change that occurs when DST ends.	No	STANDARD
dst_end.gap	boolean	Is there a gap when the clocks jump backward or not.	No	STANDARD
dst_end.dateTimeAfter	string	The local date and time that immediately follows the ends of DST.	No	STANDARD
dst_end.dateTimeBefore	string	The local date and time immediately before DST ends.	No	STANDARD
dst_end.overlap	boolean	Whether there is an overlap of time due to clocks being set back when DST ends.	No	STANDARD

• `user_agent` json object reference

Field	Type	Description	Can be empty?	Availability
user_agent_string	string	User-Agent string passed along with the query in the 'User-Agent' header.	No	STANDARD
name	string	User-Agent Name.	No	STANDARD
type	string	User-Agent Class.	No	STANDARD
version	string	User-Agent Version.	No	STANDARD
version_major	string	User-Agent Version Major.	No	STANDARD
device.name	string	Device Name.	No	STANDARD
device.type	string	Device Type.	No	STANDARD
device.brand	string	Device Brand.	No	STANDARD
device.cpu	string	Device CPU Model.	No	STANDARD
engine.name	string	Layout Engine Name	No	STANDARD
engine.type	string	Layout Engine Class	No	STANDARD
engine.version	string	Layout Engine Version.	No	STANDARD
engine.version_major	string	Layout Engine Version Major.	No	STANDARD
operating_system.name	string	Operating System Name.	No	STANDARD
operating_system.type	string	Operating System Class.	No	STANDARD
operating_system.version	string	Operating System Version.	No	STANDARD
operating_system.version_major	string	Operating System Version Major.	No	STANDARD
operating_system.build	string	Operating System Version Major.	No	STANDARD

For all possible values of the User Agent type fields, please check here.

Error Codes

IP Geolocation API returns HTTP status code 200 for a successful API request along with the response.

While, in case of a bad or invalid request, IP Geolocation API returns 4xx HTTP status code along with a descriptive message explaining the reason for the error.

Below is a detailed explanation of the specific HTTP status codes and their corresponding error conditions:

HTTP Status	Description
400 Bad Request	It is returned for one of the following reasons: If the provided IPv4, IPv6 address, or domain name is invalid. If special character(s) ( ) [ ] { } \| ^ ` is passed in the API URL either as paramter or its value. Specially in case of API key. If the IP addresses JSON list is empty, or the provided JSON does not have 'ips' field while querying `/ipgeo-bulk` endpoint. If more than 50,000 IP addresses are provided while quering from `/ipgeo-bulk` endpoint.
401 Unauthorized	It is returned for one of the following reasons: If API key (as `apiKey` URL parameter) is missing from the request to IP Geolocation API. If an invalid (a random value) API key is provided. If the API request is made from an unverified ipgeolocation.io account. If your account has been disabled or locked to use by the admin due to abuse or illegal activity. When the request to IP Geolocation API is made using API key for a database subscription When the request to IP Geolocation API is made on the 'paused' subscription. If you’re making API requests after your subscription trial has been expired. If your active until date has passed and you need to upgrade your account. If IP-hostname lookup, IP-security lookup or user-agent parsing endpoint is called using free subsciption API key. If bulk IP to geolocation look-ups endpoint is called using free subscription API key.
403 Forbidden	If IP to geolocation look-up for a domain name is done using a free subscription API key.
404 Not Found	It is returned for one of the following reasons: If the IPv4, IPv6, or domain name does not not exists in our database. If the IPv4, IPv6, or domain name is passed as a path variable, instead of url parameter as `ip=` . If the wrong endpoint is called, that does not exists in our API.
405 Method Not Allowed	If wrong HTTP request method is used for calling the endpoints. Only GET and POST methods are allowed. POST method for `/ipgeo-bulk` endpoint and GET method for `/ipgeo` endpoint requests.
413 Content Too Large	If the passed data in the POST requests is more than the limit of the API.
415 Unsupported Media Type	If the payload for IPs in `/ipgeo-bulk` endpoint is mising, or the content type is not mentioned as JSON.
423 Locked	If the passed IP address is from a bogon ip ranges, or is part of a private network.
429 Too Many Requests	It is returned for one of the following reasons: If the API usage limit has reached for the free subscriptions, or paid subscriptions with the status 'past due', 'deleted' or 'trial expired'. If the surcharge API usage limit has reached against the subscribed plan.
499 Client Closed Request	If the client has set the very short request or connection timeout, leading to the server closing the request prematurely.
5XX Server Side Error	If a `500` (Internal Server Error), `502` (Bad Gateway), `503` (Service Unavailable), `504` (Gateway Timeout), or `505` (HTTP Version Not Supported) status code is returned, it indicates an issue on our end. Please contact us with your request at support@ipgeolocation.io for further assistance.

API SDKs

To facilitate the developers, we have added some SDKs for various programming languages. The detailed documentation on how to use these SDKs is available in the respective SDK's documentation page linked below.

Our SDKs are also available on Github. Feel free to help us improve them. Following are the available SDKs:

IP Geolocation FAQs

What information can I obtain using the IP Location API?

Does the IP Location API support batch IP address lookups?

Are there SDKs available for the IP Location API?

How frequently is the geolocation data updated?

What security measures are in place for the IP Location API?

What is IP Geolocation and how does it work?

How accurate is IP Geolocation data?

What can I use IP Geolocation for, in my application or website?

What is an IP Geolocation API?

How do I get an IP Geolocation API key?

Is there a free IP Geolocation API available?

How do I integrate an IP Geolocation API into my website?

Can I track user locations in real time with an IP Geolocation API?

What’s the difference between IP Geolocation API and GPS location services?

How do I secure my IP Geolocation API to prevent misuse?

Can ipgeolocation.io's API identify attackers or spammers?

How can businesses utilize ipgeolocation.io's security data?

Does IP Location API provide real-time security information for IP addresses?

Overview
Single IP Geolocation Lookup API
Passing an IPv4, IPv6 Address or a domain
Without Passing an IP Address
Bulk IP Geolocation Lookup API
Response in Multiple Languages
Filter Responses
IP-Security Information for an IP Address
Abuse Contact Info for an IP Address
DMA Code Assoc. with IP Address
Hostname Lookup for an IP Address
Time Zone Lookup for an IP Address
User-Agent Device Info
Reference to IPGeolocation API Response
Error Codes
API SDKS
FAQs

Free IP Lookup API and Accurate IP Location Finder

IP Location Module

Response

Country Metadata Module

Response

Network Module

Response

Currency Module

Response

Security Module

Response

Abuse Contact Module

Response

Time Zone Module

Response

User Agent Parser Module

Response

Reverse IP Lookup Module

Response

Response

Domain IP Lookup

Response

Bulk IP Address Lookup Support

Response

Response in Multiple Languages

Use Cases

Website content localization

Non-intrusive geolocation

Digital Rights Protection

Prevent Threats and Scams

Ready to get started? Get Started with IP Intelligence API Today

IP Geolocation API Documentation

IP Geolocation API

Single IP Geolocation Lookup API

Passing an IPv4, IPv6 Address or a domain

Passing an IPv4

Passing an IPv6

Passing a Domain

Without Passing an IP Address

Bulk IP Geolocation Lookup API

Response in Multiple Languages

Filter Responses

• Get the Required Fields Only

Get location Information Only

Get Country Name and Organization Only

Get Only the Local Currency Information of Multiple IP Addresses

• Remove the Unnecessary Fields

Exclude Continent Code, Currency and, Network Objects

• Get the Location Fields and Exclude Continent Information

IP-Security Information for an IP Address

Abuse Contact Information for an IP Address

DMA Code for an IP Address

Hostname Lookup for an IP Address

include=hostname URL Parameter

include=liveHostname URL Parameter

include=hostnameFallbackLive URL Parameter

Time Zone Information for an IP Address

User-Agent Information for a Device

Reference to IPGeolocation API Response

• location json object reference

• country_metadata json object reference

• network json object reference

• currency json object reference

• security json object reference

• abuse json object reference

• time_zone json object reference

• user_agent json object reference

Error Codes

API SDKs

IP Geolocation FAQs

`include=hostname` URL Parameter

`include=liveHostname` URL Parameter

`include=hostnameFallbackLive` URL Parameter

• `location` json object reference

• `country_metadata` json object reference

• `network` json object reference

• `currency` json object reference

• `security` json object reference

• `abuse` json object reference

• `time_zone` json object reference

• `user_agent` json object reference