The TimezoneAPI has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors. All API access is over https. All data is received as JSON, including errors.


TimezoneAPI can be used for many different tasks.

  • Get location details from a users IP address
    Returns your users location, timezone information and datetime. https://timezoneapi.io/api/ip
  • Lookup an address
    Returns one or multiple addresses, timezone information and datetime. https://timezoneapi.io/api/address/?1600+Amphitheatre+Pkwy+Mountain+View
  • Lookup a timezone
    Returns timezone information and datetime. https://timezoneapi.io/api/timezone/?Europe/Paris
  • Compare ip address, address and time zones
    Returns ip address details, address information or timezone information and datetime. https://timezoneapi.io/api/compare/timezone-with-ip/?timezone1=Europe/Paris&ip1=

Rate limits

TimezoneAPI is free if you make less than 50 requests /day.
If you exceed 50 requests /day we'll return a 429 HTTP status code.
If you need to make more requests, then subscribe to a paid plan, which all have soft limits.