The time.you Developer API

Accelerate your development with a high-performance, free JSON API designed for sub-millisecond temporal synchronization and global timezone resolution.

Precise time management is a cornerstone of modern distributed systems. Whether you are building complex financial dashboards, IoT synchronization protocols, or cross-platform mobile applications, obtaining a reliable source of truth for global time is essential. The time.you API abstracts away the complexities of IANA database maintenance, daylight saving calculations, and IP-based location detection, delivering atomic-accurate data through a simple, stateless interface.

⚡ Low Latency – Global CDN edge points for millisecond response times.
🔗 Zero configuration – No API keys, no headers, no friction.
🛠️ Stateless Architecture – Ready for Serverless, Edge, and IoT environments.
📅 Complete Temporal Data – Includes Unix epoch, ISO8601, DST offsets, and week numbers.

📜 Free Usage & Attribution

This API is provided as a free public utility. To support its continued growth and maintenance, we require that all applications using the time.you API provide a visible attribution link back to our site.

Standard Attribution Snippet:

<a href="https://time.you">Powered by time.you World Time API</a>

Base URL

All API requests should be made via HTTPS to:

https://time.you/developer/api

API Endpoints

GET /timezone/:area/:location

Request the current time object for a specific IANA timezone.

Example Request:

GET https://time.you/developer/api/timezone/Europe/London

Example JSON Response:

{
  "abbreviation": "BST",
  "datetime": "2023-10-05T14:30:00.123456+01:00",
  "day_of_week": 4,
  "day_of_year": 278,
  "dst": true,
  "dst_offset": 3600,
  "timezone": "Europe/London",
  "unixtime": 1696512600,
  "utc_datetime": "2023-10-05T13:30:00.123456Z",
  "utc_offset": "+01:00",
  "week_number": 40
}

GET /ip

Get the current time based on the public IP address of the requester. This is useful for auto-detecting a user's local time without asking for location permissions.

Auto-Detect IP Request:

GET https://time.you/developer/api/ip

Specific IP Lookup Request:

GET https://time.you/developer/api/ip/8.8.8.8

GET /timezone

Returns a list of all available valid IANA timezone strings as a JSON array.

GET https://time.you/developer/api/timezone

JSON Response Schema

The API returns a JSON object with the following fields:

Key	Type	Description
`timezone`	String	The IANA timezone name (e.g., America/New_York).
`datetime`	String	Current local time in ISO8601 format with offset.
`unixtime`	Integer	Seconds since the Unix Epoch (UTC).
`utc_offset`	String	The offset from UTC as a string (e.g., +05:30).
`abbreviation`	String	Short timezone name (e.g., EST, JST, CST).
`dst`	Boolean	True if Daylight Saving Time is currently active.
`dst_offset`	Integer	Seconds added due to DST (usually 0 or 3600).
`client_ip`	String	The IP address used for the geo-lookup.

Code Examples

JavaScript (Fetch)

fetch('https://time.you/developer/api/ip')
  .then(response => response.json())
  .then(data => {
    console.log('Current time:', data.datetime);
    console.log('Timezone:', data.timezone);
  });

Python (Requests)

Example request for Asia/Tokyo:

import requests

response = requests.get('https://time.you/developer/api/timezone/Asia/Tokyo')
data = response.json()
print(f"Current time in Tokyo: {data['datetime']}")

cURL

curl "https://time.you/developer/api/timezone/Europe/Paris"