Airport Timezones
Look up any of the world's airports by name, city, ICAO or IATA code and get its current local time computed from the IANA timezone database, with correct handling of daylight-saving gaps and folds. The same data is available as a free JSON API.
Public JSON API
Base URL https://airport-timezone.hammond.zone/api/v1/. All
responses are JSON (Content-Type: application/json). No key is required to start.
Endpoints
-
GET /api/v1/airports/{code}Look up one airport by ICAO, IATA or ident code, including its current local time. -
GET /api/v1/airports?search=&country=Search by name, city or code, optionally filtered by ISO country code. Paginated. -
GET /api/v1/airports/suggest?q=Lightweight autocomplete suggestions for building a search-as-you-type box. -
GET /api/v1/airports/{code}/time?at=Resolve the local time at any instant or wall-clock time, past or future, with full DST gap/fold handling. -
GET /api/v1/near?lat=&lon=Nearest airports to a coordinate by great-circle distance.
Try it
curl https://airport-timezone.hammond.zone/api/v1/airports/YPPH
More examples — one for every endpoint
Look up an airport by ICAO, IATA or ident code
curl https://airport-timezone.hammond.zone/api/v1/airports/YSSY
Search by name or city, filtered by ISO country code
curl "https://airport-timezone.hammond.zone/api/v1/airports?search=sydney&country=AU"
Autocomplete suggestions for a search-as-you-type box
curl "https://airport-timezone.hammond.zone/api/v1/airports/suggest?q=syd"
Resolve a local wall-clock time (DST gaps/folds handled; add disambiguation=)
curl "https://airport-timezone.hammond.zone/api/v1/airports/YSSY/time?at=2026-04-05T02:30:00"
Nearest airports to a coordinate, by great-circle distance
curl "https://airport-timezone.hammond.zone/api/v1/near?lat=-33.95&lon=151.18&limit=5"
Rate limits
Without an API key, requests are limited per client IP: 1 request/second
(burst 3) for the general endpoints, and a more generous 5 requests/second
(burst 20) for autocomplete. Over the limit you get 429 Too Many Requests with a
Retry-After header.
API keys — unlimited access
For unmetered access, pass an API key as an Authorization: Bearer <key>
header (or ?api_key= for convenience). API keys are not rate limited and are free.
Register for an API key — confirm your email and your key is issued
instantly (valid for 12 months).