Airport Time Zone API

Show departure and arrival times in the right local time zone. Retrieve airport time zone identifiers alongside airport codes and names, or download the directory to support time conversion across your travel product.

  • Lookup by IATA or ICAO code
  • Time zone identifiers and UTC offsets
  • JSON, XML and CSV

Look up an airport’s time zone

Pass LHR in the iata parameter to retrieve London Heathrow Airport and its Europe/London time zone. Replace YOUR_API_KEY with your assigned key.

Request · cURL

curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'iata=LHR'

Response · JSON excerpt

[
  {
    "airhex_id": "53779",
    "iata": "LHR",
    "icao": "EGLL",
    "name": "London Heathrow Airport",
    "timezone": "Europe/London",
    "utc": "1",
    ...
  }
]

Abbreviated response. The ellipsis (…) represents omitted fields and is not part of the actual JSON. The UTC offset shown is an example, not a year-round offset; use the time zone identifier and the travel date for conversion.

View the full Airports API reference →

Request parameters

Look up a specific airport, find airports by location, or export the directory with these query parameters.

ParameterRequiredDefaultDescription
apikey YesNoneYour assigned API key. Get a free test API key.
iata ConditionalNoneThree-letter IATA airport code, such as LHR.
icao ConditionalNoneFour-letter ICAO airport code, such as EGLL.
city_code ConditionalNoneThree-letter IATA city code, such as LON, to find airports associated with a city.
country_code ConditionalNoneTwo-letter ISO country code, such as GB, to find airports in a country.
name ConditionalNoneAirport name or partial name, such as Heathrow.
dump Conditional0Set to 1 to export the database. Overrides the other lookup parameters; coverage filters still apply.
show_disabled No0Set to 1 to include inactive or disabled records. By default, only active records are returned.
response_type NoJSONResponse format: JSON, XML or CSV. CSV triggers a file download.
major_only No0Set to 1 to include only airports with commercial flights.

Provide at least one of iata, icao, city_code, country_code, name, or dump=1. Setting dump=1 overrides the other lookup parameters.

View all request parameters →

Available data

Use timezone with a date-aware time zone library to display local times. Keep airport identifiers alongside it so departure and arrival locations are mapped separately.

FieldTypeExampleDescription
airhex_id Identifier53779Permanent Airhex record identifier for maintaining your local airport directory.
iata StringLHRThree-letter airport code for matching departure and arrival locations.
icao StringEGLLFour-letter airport identifier for matching aviation data sources.
name StringLondon Heathrow AirportAirport name for itinerary and passenger-information displays.
timezone StringEurope/LondonNamed time zone identifier. Use it with the relevant timestamp to determine local time.
utc Offset1UTC offset supplied in the airport record. Do not treat it as a fixed offset for every travel date.

View all available data →

Common implementation tasks

Download airport time zones for your itineraries

Export active airports with commercial flights as CSV and retain timezone alongside airhex_id and airport codes. Your application can then resolve the time zone for each itinerary leg from a local directory.

curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'dump=1' \
  --data-urlencode 'major_only=1' \
  --data-urlencode 'response_type=CSV' \
  --output airport-timezones.csv

Retrieve a time zone using an ICAO code

Use icao when your source identifies airports with four-letter codes. This request resolves EGLL to the same Heathrow record and time zone as an IATA lookup for LHR.

curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'icao=EGLL'

Display a supplied UTC timestamp in airport local time

After retrieving timezone, pass it to your application’s date-time formatter with an unambiguous timestamp from your flight supplier. This JavaScript example uses Europe/London from the response. The timestamp is illustrative; the Airports API does not supply flight times.

const airportTimeZone = 'Europe/London';
const departureUtc = '2026-07-15T12:00:00Z';

const localDeparture = new Intl.DateTimeFormat('en-GB', {
  timeZone: airportTimeZone,
  dateStyle: 'medium',
  timeStyle: 'short'
}).format(new Date(departureUtc));

// 15 Jul 2026, 13:00

What you can build

Clear departure and arrival times

Display each end of a journey in its own airport’s local time, with dates that help travelers understand overnight trips.

Passenger reminders

Use airport time zones in your notification logic so departure reminders can be shown in the local context of the traveler’s journey.

Consistent support and reporting

Let support teams view flight timestamps in airport local time while your systems retain unambiguous timestamps for comparisons and reporting.

Frequently asked questions

What is the difference between timezone and utc?

timezone identifies a named zone, such as Europe/London. utc supplies an offset in the airport record. An offset alone does not describe daylight-saving rules or changes across dates. Use the named zone with the actual travel timestamp when converting times.

How should I handle daylight saving time?

Use timezone with a date-aware library backed by current time zone rules. The library determines the offset for the date being converted. Do not apply the example UTC offset to every flight, and keep your application’s time zone data current as rules can change.

Does the API convert flight times for me?

No. It returns airport reference data, including time zone identifiers. Your application performs the conversion using timestamps supplied by your flight provider. There is no travel-date or time-conversion parameter on this endpoint.

What if my supplier already sends local flight times?

Confirm the supplier’s timestamp format before converting. Do not interpret a local time as UTC or convert it twice. A local date and time without an offset can be ambiguous around daylight-saving transitions; use an explicit offset or UTC timestamp from the supplier when available.

How do I handle departure and arrival in different time zones?

Resolve each airport separately and format each timestamp using that airport’s timezone. Include the local date where a journey crosses midnight. Calculate elapsed journey time from unambiguous timestamps, rather than subtracting the displayed local clock times.

Can I assume all airports in a country use the same time zone?

No. Retrieve the time zone for the specific airport record rather than inferring it from the country. If you search by city_code or country_code, read timezone from each returned airport.

Can I store airport time zones in my own database?

Yes, with an appropriate GEO Essentials license. Export with dump=1 and choose JSON, XML or CSV using response_type. Retain airhex_id and updated from the full response, refresh your airport mappings periodically, and maintain current time zone rules in the software that performs conversions.

What should I do if a time zone is missing or unsupported?

Validate the returned timezone before passing it to your formatter. Preserve the supplier’s original timestamp and offset where available, and flag unresolved mappings for review. Do not silently substitute the user’s device time zone or a guessed country-wide offset.

Give travelers clear local times for every airport

Support consistent local-time displays across itineraries, reminders and passenger information, without maintaining your own airport-to-time-zone directory.

Airports API →

Explore the complete airport dataset, including IATA and ICAO codes, names, city and country identifiers, time zones, coordinates, operational status and contact details. View all request parameters, coverage filters and response fields, with individual lookups and bulk exports in JSON, XML and CSV.

Airport Coordinates API →

Look up airport latitude and longitude by IATA or ICAO code, or export coordinates for airport maps and location search in your travel product.

Airport IATA Codes API →

Look up airport IATA codes, match codes to airport names, cities and ICAO identifiers, or export an airport code directory with the Airhex API.

Airport ICAO Codes API →

Look up airport ICAO codes, match them to airport names and IATA codes, or export a directory to connect aviation and travel data with the Airhex API.