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/?token=TOKEN
  • Lookup an address
    Returns one or multiple addresses, timezone information and datetime. https://timezoneapi.io/api/address/?1600+Amphitheatre+Pkwy+Mountain+View&token=TOKEN
  • Lookup a timezone
    Returns timezone information and datetime. https://timezoneapi.io/api/timezone/?Europe/Paris&token=TOKEN
  • 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=

Testing 1, 2, 3.. Sign up when you're ready!

We've made it easy for you to test out our API's. Simply click the "Token" link on each API page and a temporary token is generated instantly. You can generate up to five test tokens. Each token is valid for 20 requests. When you're ready to put the code into production then sign up for a plan to get a service token.

Service Token  (for testing)

A test token has been generated for you. It's good for 20 requests. Please notice: When using a test token the request reponse time is reduced drastically.

TOKEN Copied note_add