CTRL+K

Timezone API

GET

https://api.apifreaks.com/v1.0/geolocation/timezone

format

Format of the Response

ipString

IPv4/IPv6 address to extract timezone info using IP address

tzString

Extract timezone information using timezone name

locationString

Extract timezone information using location (preferably city and country)

latNumber

Latitude to extract timezone information using location coordinates

longNumber

Longitude to extract timezone information using location coordinates

langString

Response language of "location" field in case of lookup through IP address / location address

iata_codeString

Extract timezone info using 3-letter IATA airport code

icao_codeString

Extract timezone info using 4-letter ICAO airport code

lo_codeString

Extract timezone info using 5-letter UN/LO CODE city code

Sample Responses

400

404

400

LANGUAGE

Python

PHP

Java

Node

Ruby


$ pip install requests

RESPONSE

Click Test it to start the request and see the response here!

API Response

Below are the response fields when performing a lookup using geographical coordinates or a time-zone name:

Field	Type	Requirement	Description
ip	String	Optional	IP address
location	Object	Optional	Location information
time_zone	Object	Mandatory	Timezone information
airport_details	Object	Optional	Airport details
lo_code_details	Object	Optional	LO code details

The 'timezone' object includes the following fields:

Field	Type	Requirement	Description
name	String	Mandatory	The name of the timezone, e.g., "Asia/Karachi"
offset	Number	Mandatory	The time difference in hours from UTC for the specified timezone without considering DST
offset_with_dst	Number	Mandatory	The time difference in hours from UTC for the specified timezone, including DST
date	String	Mandatory	The current date in the specified timezone in YYYY-MM-DD format
date_time	String	Mandatory	The current date and time in the specified timezone in ISO 8601 format
date_time_txt	String	Mandatory	The current date and time in a human-readable format, e.g., "Tuesday, September 02, 2025 14:56:21"
date_time_wti	String	Mandatory	The current date and time in the specified timezone in "Weekday, Time" format
date_time_ymd	String	Mandatory	The current date and time in "YYYY-MM-DD HH:MM:SS" format
date_time_unix	Float	Mandatory	The current date and time as a Unix timestamp (seconds since Jan 1, 1970)
time_24	String	Mandatory	The current time in 24-hour format, e.g., "14:56:21"
time_12	String	Mandatory	The current time in 12-hour format with AM/PM, e.g., "02:56:21 PM"
week	Number	Mandatory	The current week number of the year in the specified timezone
month	Number	Mandatory	The current month number in the specified timezone
year	Number	Mandatory	The current year in the specified timezone
year_abbr	String	Mandatory	The abbreviated current year in the specified timezone, e.g., "25" for 2025
current_tz_abbreviation	String	Mandatory	The current timezone abbreviation
current_tz_full_name	String	Mandatory	The current timezone full name
standard_tz_abbreviation	String	Mandatory	The standard timezone abbreviation
standard_tz_full_name	String	Mandatory	The standard timezone full name
is_dst	Boolean	Mandatory	Indicates whether Daylight Saving Time (DST) is currently in effect in the specified timezone
dst_savings	Number	Mandatory	The amount of time (in hours) by which clocks are adjusted for DST
dst_exists	Boolean	Mandatory	Indicates whether DST is observed in the specified timezone
dst_start.utc_time	String	Optional	The date and time in UTC when DST begins.
dst_start.duration	String	Optional	The time change that occurs when DST starts.
dst_start.gap	Boolean	Optional	Is there a gap when the clocks jump forward or not.
dst_start.date_time_after	String	Optional	The local date and time that immediately follows the start of DST.
dst_start.date_time_before	String	Optional	The local date and time immediately before DST begins.
dst_start.overlap	Boolean	Optional	Whether there is an overlap of time due to clocks being set back when DST starts.
dst_end.utc_time	String	Optional	The date and time in UTC when DST ends.
dst_end.duration	String	Optional	The time change that occurs when DST ends.
dst_end.gap	Boolean	Optional	Is there a gap when the clocks jump backward or not.
dst_end.date_time_after	String	Optional	The local date and time that immediately follows the ends of DST.
dst_end.date_time_before	String	Optional	The local date and time immediately before DST ends.
dst_end.overlap	Boolean	Optional	Whether there is an overlap of time due to clocks being set back when DST ends.

The following fields will be appended to the above response based on the lookup performed using a location address:

Field	Type	Requirement	Description
location_string	String	Mandatory	The complete geographical location, including country, state, city, and locality
country_name	String	Mandatory	Country name
state_prov	String	Mandatory	The state or province of the geographical location
city	String	Mandatory	The city of the geographical location
locality	String	Mandatory	The locality or neighborhood of the geographical location
latitude	String	Mandatory	The latitude coordinate of the geographical location
longitude	String	Mandatory	The longitude coordinate of the geographical location

The following fields will be appended to the above response based on the lookup performed using an IP address:

Field	Type	Requirement	Description
continent_code	String	Mandatory	The 2-letter continent code
continent_name	String	Mandatory	The continent name
country_code2	String	Mandatory	The 2-letter country code (ISO 3166-1 alpha-2)
country_code3	String	Mandatory	The 3-letter country code (ISO 3166-1 alpha-3)
country_name	String	Mandatory	The common name of the country
country_name_official	String	Mandatory	The official name of the country
is_eu	Boolean	Mandatory	Is the country belong to European Union?
state_prov	String	Mandatory	The state or province of the geographical location
state_code	String	Mandatory	The state or province code
district	String	Mandatory	The district of the geographical location
city	String	Mandatory	The city of the geographical location
zipcode	String	Mandatory	The ZIP code of the geographical location
latitude	String	Mandatory	The latitude coordinate of the geographical location
longitude	String	Mandatory	The longitude coordinate of the geographical location

The following fields will be appended to the above response based on the lookup performed using an ICAO or an IATA code:

Field	Type	Requirement	Description
type	String	Mandatory	The type of airport (small, medium, large)
name	String	Mandatory	The full name of the airport
longitude	String	Mandatory	The longitude coordinate of the airport location
latitude	String	Mandatory	The latitude coordinate of the airport location
elevation_ft	Number	Mandatory	The elevation of the airport in feet
continent_code	String	Mandatory	The 2-letter continent code where the airport is located
country_code	String	Mandatory	The 2-letter country code where the airport is located
state_code	String	Mandatory	The state or province code where the airport is located
city	String	Mandatory	The city or municipality where the airport is located
iata_code	String	Mandatory	The IATA (International Air Transport Association) code for the airport
icao_code	String	Mandatory	The ICAO (International Civil Aviation Organization) code for the airport
faa_code	String	Mandatory	The FAA (Federal Aviation Administration) code for the airport

The following fields will be appended to the above response based on the lookup performed using a UN/LO CODE code:

Field	Type	Requirement	Description
lo_code	String	Mandatory	The UN/LO CODE code for the location
city	String	Mandatory	The name of the city or location
longitude	String	Mandatory	The longitude coordinate of the location
latitude	String	Mandatory	The latitude coordinate of the location
state_code	String	Mandatory	The state or province code of the location
country_code	String	Mandatory	The 2-letter country code of the location
country_name	String	Mandatory	The name of the country
location_type	String	Mandatory	The type of the location (e.g., port, airport, rail terminal)