Loading
Loading
Resolve any location identifier to its current timezone, local time, UTC offset, and full DST details. Supports IP addresses, GPS coordinates, city or address strings, IATA airport codes, ICAO codes, UN/LOCODEs, and IANA timezone names.
The Timezone Lookup API returns the current time in six formats, UTC offset with and without DST, DST transition timestamps (start and end), timezone abbreviation, and Unix timestamp for any supported location input. IATA and ICAO lookups also return full airport details. UN/LOCODE lookups include city, state, country, and location type. IP and address lookups support 9 response languages via the lang parameter.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
All parameters are optional query string parameters. Pass any one of location, lat/long, ip, tz, iata_code, icao_code, or lo_code. If no parameter is provided, the API resolves the timezone for the calling machine's IP address.
ipoptionalStringIPv4/IPv6 address to extract timezone info using IP address
tzoptionalStringExtract timezone information using timezone name
locationoptionalStringdefault: London, UKExtract timezone information using location (preferably city and country)
latoptionalNumberLatitude to extract timezone information using location coordinates
longoptionalNumberLongitude to extract timezone information using location coordinates
langoptionalStringdefault: enResponse language of "location" field in case of lookup through IP address / location address
iata_codeoptionalStringExtract timezone info using 3-letter IATA airport code
icao_codeoptionalStringExtract timezone info using 4-letter ICAO airport code
lo_codeoptionalStringExtract timezone info using 5-letter UN/LO CODE city code
A successful request returns a 200 OK response with a JSON object. The time_zone object is always present. Additional top-level objects appear based on the lookup method used. See the response preview on the right for the full JSON structure.
ipIP address
locationLocation information
time_zoneTimezone information
airport_detailsAirport details
lo_code_detailsLO code details
The time_zone object is always returned and includes the following fields:
nameThe name of the timezone, e.g., "Asia/Karachi"
offsetThe time difference in hours from UTC without considering DST
offset_with_dstThe time difference in hours from UTC including DST
dateThe current date in YYYY-MM-DD format
date_timeThe current date and time in ISO 8601 format
date_time_txtThe current date and time in human-readable format
date_time_wtiThe current date and time in "Weekday, Time" format
date_time_ymdThe current date and time in "YYYY-MM-DD HH:MM:SS" format
date_time_unixThe current date and time as a Unix timestamp
time_24The current time in 24-hour format
time_12The current time in 12-hour format with AM/PM
weekThe current week number of the year
monthThe current month number
yearThe current year
year_abbrThe abbreviated current year, e.g., "25" for 2025
current_tz_abbreviationThe current timezone abbreviation
current_tz_full_nameThe current timezone full name
standard_tz_abbreviationThe standard timezone abbreviation
standard_tz_full_nameThe standard timezone full name
is_dstWhether DST is currently in effect
dst_savingsThe amount of time (in hours) clocks are adjusted for DST
dst_existsWhether DST is observed in the specified timezone
dst_tz_abbreviationThe DST timezone abbreviation
dst_tz_full_nameThe DST timezone full name
dst_start.utc_timeThe date and time in UTC when DST begins
dst_start.durationThe time change when DST starts
dst_start.gapIs there a gap when clocks jump forward
dst_start.date_time_afterThe local date and time after DST starts
dst_start.date_time_beforeThe local date and time before DST starts
dst_start.overlapWhether there is an overlap when DST starts
dst_end.utc_timeThe date and time in UTC when DST ends
dst_end.durationThe time change when DST ends
dst_end.gapIs there a gap when clocks jump backward
dst_end.date_time_afterThe local date and time after DST ends
dst_end.date_time_beforeThe local date and time before DST ends
dst_end.overlapWhether there is an overlap when DST ends
When a lookup is performed using the 'location' parameter, the location object includes the following fields:
location_stringThe complete geographical location, including country, state, city, and locality
country_nameCountry name
state_provThe state or province of the geographical location
cityThe city of the geographical location
localityThe locality or neighborhood
latitudeThe latitude coordinate
longitudeThe longitude coordinate
When a lookup is performed using the 'ip' parameter, the location object includes the following fields:
continent_codeThe 2-letter continent code
continent_nameThe continent name
country_code2The 2-letter country code (ISO 3166-1 alpha-2)
country_code3The 3-letter country code (ISO 3166-1 alpha-3)
country_nameThe common name of the country
country_name_officialThe official name of the country
is_euIs the country belong to European Union?
state_provThe state or province
state_codeThe state or province code
districtThe district
cityThe city
zipcodeThe ZIP code
latitudeThe latitude coordinate
longitudeThe longitude coordinate
When a lookup is performed using 'iata_code' or 'icao_code', the airport_details object includes the following fields:
typeThe type of airport (small, medium, large)
nameThe full name of the airport
longitudeThe longitude coordinate
latitudeThe latitude coordinate
elevation_ftThe elevation in feet
continent_codeThe 2-letter continent code
country_codeThe 2-letter country code
state_codeThe state or province code
cityThe city or municipality
iata_codeThe IATA code
icao_codeThe ICAO code
faa_codeThe FAA code
When a lookup is performed using 'lo_code', the lo_code_details object includes the following fields:
lo_codeThe UN/LO CODE code
cityThe name of the city or location
longitudeThe longitude coordinate
latitudeThe latitude coordinate
state_codeThe state or province code
country_codeThe 2-letter country code
country_nameThe name of the country
location_typeThe type of the location (port, airport, rail terminal, etc.)
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
'latitude' (999) or 'longitude' (0) is not valid. 'latitude' must be between -90.0 and +90.0 and 'longitude' must be between -180.0 and +180.0.
Check whether your input values are correct; time_zone_name = Invalid/Timezone
'999.999.999.999' is not an IP string literal.
Invalid IATA code: INVALID. IATA code must be in the format of AAA.
Invalid ICAO code: INVALID. ICAO code must be in the format of AAAA.
'Data not found for the provided LO code: XXXXX Please contact at support@ipgeolocation.io if provided LO code exists.'
We couldn't find the location (ZZZNOTEXIST). Try a city or state level location address only.