IP to Timezone API: Get a Visitor's Time Zone and Currency from Their IP

An IP to timezone lookup tells you which time zone a visitor or a log entry most likely belongs to, before any JavaScript runs. One GET request returns the IANA time zone ID, the current local time, the DST status and the UTC offset, plus the country’s currencies. Below you find the call, each field explained, IP vs browser time zones, and code for curl, Node.js, Python and PHP.

Your own public IP address and the time zone it maps to are shown below. If you use a VPN, you will see the VPN exit location, not yours.

How to get the time zone from an IP address

Send the IP address to GET /v1/info. The fields parameter limits the response to the data you need. Put your API key in the apikey header rather than the URL, so it stays out of access logs.

curl -H "apikey: YOUR_API_KEY" \
  "https://api.iplookupapi.com/v1/info?ip=80.110.0.1&fields=ip,timezone,location.country.timezones,location.country.currencies"

The response for this Vienna, Austria address looks like this:

{
  "data": {
    "ip": "80.110.0.1",
    "location": {
      "country": {
        "currencies": [
          {
            "symbol": "€",
            "name": "Euro",
            "symbol_native": "€",
            "decimal_digits": 2,
            "rounding": 0,
            "code": "EUR",
            "name_plural": "Euros",
            "type": "fiat"
          }
        ],
        "timezones": ["Europe/Vienna"]
      }
    },
    "timezone": {
      "id": "Europe/Vienna",
      "current_time": "2026-10-14T16:46:37+02:00",
      "code": "CEST",
      "is_daylight_saving": true,
      "gmt_offset": 7200
    }
  }
}

Without ip, the API answers for the caller’s own IP, which on a server is your server, so always pass the visitor’s IP. All parameters are in the info endpoint documentation.

What each time zone field means

IDs such as America/New_York come from the IANA time zone database, which operating systems, browsers and languages use. Each ID carries the offset and DST rules for its area.

Countries with several time zones

The timezone object follows the city and region of the IP address, not the country. In the US, an IP in Chicago returns America/Chicago and an IP in Phoenix returns America/Phoenix, which does not observe DST. location.country.timezones lists every ID of the country, useful for a short pick list when the city is unknown.

IP time zone vs browser time zone

In the browser, one line returns the time zone the user’s device is set to. It needs no API key:

const browserTimeZone = Intl.DateTimeFormat().resolvedOptions().timeZone; // e.g. "America/Chicago"

For fraud checks, compare UTC offsets, not IDs: America/Detroit and America/New_York show the same clock time. In the browser, -new Date().getTimezoneOffset() * 60 gives the current offset in seconds, with the same sign as gmt_offset. A gap of several hours is worth a second look, not proof of fraud, since travelers cause the same pattern.

What you can do with IP time zone data

• Send emails and notifications at local times. Schedule a newsletter for 9:00 AM in each recipient’s time zone instead of one global time.
• Show local times and dates. Render event times, deadlines and opening hours in the visitor’s time zone on the first page load.
• Prefill sign-up forms. Preselect the time zone field so users only confirm it.
• Schedule meetings. Suggest slots in the invitee’s working hours.
• Spot risky sessions. Flag logins where IP and browser time zones are far apart.

To process existing customer lists or log files, send up to 1,000 addresses per request with the batch IP lookup API.

Daylight saving time: store the IANA ID, not the offset

gmt_offset, code and is_daylight_saving describe the current moment only. Vienna is UTC+2 in summer and UTC+1 in winter, so a January reminder based on a stored 7200 fires an hour off. Store timezone.id and let a date library apply the IANA rules for each date.

Code examples: Node.js, Python and PHP

All examples read the key from the environment variable IPLOOKUPAPI_KEY.

Node.js: format a time in the visitor’s time zone

Requires Node.js 18 or later (built-in fetch).

const API_KEY = process.env.IPLOOKUPAPI_KEY;

async function lookupTimezone(ip) {
  const url = new URL("https://api.iplookupapi.com/v1/info");
  url.searchParams.set("ip", ip);
  url.searchParams.set("fields", "ip,timezone,location.country.currencies");

  const res = await fetch(url, { headers: { apikey: API_KEY } });
  if (!res.ok) {
    throw new Error(`Lookup failed with HTTP ${res.status}`);
  }
  const body = await res.json();
  return body.data;
}

async function main() {
  const data = await lookupTimezone("80.110.0.1");
  const timeZone = data.timezone.id; // "Europe/Vienna"

  const webinarStart = new Date("2026-12-03T17:00:00Z");
  const local = new Intl.DateTimeFormat("en-US", {
    timeZone,
    weekday: "long",
    month: "long",
    day: "numeric",
    hour: "numeric",
    minute: "2-digit",
    timeZoneName: "short",
  }).format(webinarStart);

  console.log(`${timeZone}: ${local}`); // Europe/Vienna: Thursday, December 3 at 6:00 PM GMT+1
}

main().catch((err) => {
  console.error(err);
  process.exit(1);
});

Python: schedule an email for 9:00 AM local time

Uses zoneinfo from the standard library (Python 3.9+) and requests (pip install requests). On Windows, also run pip install tzdata.

import os
from datetime import datetime, time, timedelta, timezone
from zoneinfo import ZoneInfo

import requests

API_KEY = os.environ["IPLOOKUPAPI_KEY"]


def lookup_timezone(ip: str) -> dict:
    resp = requests.get(
        "https://api.iplookupapi.com/v1/info",
        params={"ip": ip, "fields": "ip,timezone,location.country.currencies"},
        headers={"apikey": API_KEY},
        timeout=5,
    )
    resp.raise_for_status()
    return resp.json()["data"]


data = lookup_timezone("80.110.0.1")
tz = ZoneInfo(data["timezone"]["id"])

now_local = datetime.now(tz)
send_date = now_local.date()
if now_local.time() >= time(9, 0):
    send_date += timedelta(days=1)

send_local = datetime.combine(send_date, time(9, 0), tzinfo=tz)
send_utc = send_local.astimezone(timezone.utc)
print(f"Send at {send_local.isoformat()} local = {send_utc.isoformat()} UTC")

zoneinfo picks the correct offset for the target date, so the email still goes out at 9:00 AM after a DST change. See the Python zoneinfo documentation for details.

PHP: local time and a UTC timestamp for storage

Works with plain PHP (allow_url_fopen enabled).

<?php
$apiKey = getenv('IPLOOKUPAPI_KEY');
$query = http_build_query([
    'ip' => '80.110.0.1',
    'fields' => 'ip,timezone,location.country.currencies',
]);

$context = stream_context_create([
    'http' => [
        'method' => 'GET',
        'header' => "apikey: {$apiKey}\r\n",
        'timeout' => 5,
    ],
]);

$body = file_get_contents("https://api.iplookupapi.com/v1/info?{$query}", false, $context);
if ($body === false) {
    exit("Lookup failed\n");
}
$data = json_decode($body, true)['data'];

$tz = new DateTimeZone($data['timezone']['id']);
$localNow = new DateTime('now', $tz);
echo 'Local time: ', $localNow->format('Y-m-d H:i T'), PHP_EOL;

// Tomorrow at 9:00 in the visitor's time zone, converted to UTC for storage
$sendAt = new DateTime('tomorrow 09:00', $tz);
$sendAt->setTimezone(new DateTimeZone('UTC'));
echo 'Send at: ', $sendAt->format('Y-m-d H:i:s'), ' UTC', PHP_EOL;

Official SDKs exist for Python (iplookupapi), PHP (everapi/iplookupapi-php), Ruby, C#, Rust and R; the SDK overview lists them. For JavaScript, fetch as above is all you need.

IP to currency: default prices by country

The same response includes location.country.currencies: for each currency of the country, the ISO 4217 code, symbol, name and decimal_digits, among others. Use it to preselect the currency in a pricing table or checkout and to format amounts with the right decimals.

Keep two caveats in mind:

• Some countries use more than one currency. The array can then contain several entries. Pick the first one you support, and fall back to your default currency if none match.
• The currency follows the country, not a region. EU members outside the euro area, such as Poland, Sweden or Denmark, return their own currency. Use location.country.is_in_european_union separately if you need EU membership, for example for VAT rules.

Treat the IP-based currency as a default and let buyers switch it. For country data only, see the IP to country API.

Time zone from latitude and longitude

The API takes IP addresses, not coordinates, but each response already pairs location.latitude and location.longitude with the matching timezone.id. For arbitrary GPS coordinates, you need time zone boundary polygons and a point-in-polygon check. Longitude alone is not reliable, because zone borders follow countries and states, not meridians.

Plans and limits for time zone and currency data

Time zone and currency data are included in every plan, including Free:

Yearly billing gives you two months free. In batch lookups, each valid address counts as one request. See pricing for what each plan adds, and where am I for the time zone your own connection shows.