Name: World Time – Timezone & IP Lookup | Free · $5/mo | API.market
Brand: sleeyax
SKU: api-sleeyax-world-time-api
Availability: InStock
Author: API Market

Sleeyax

# World Time API

Fast, reliable and up to date alternative to [worldtimeapi.org](http://worldtimeapi.org/). It returns the current local time details for a given timezone or IP address in JSON (or plain text) format.

## Feature Comparison

Comparison of APIs that provide similar functionality.

| Feature                                           | This project     | worldtimeapi.org | ipgeolocation.io |
| ------------------------------------------------- | ---------------- | ---------------- | ---------------- |
| 📅 Frequently updated                             | ✅               | ❌               | ❓               |
| 🟢 Reliable                                       | ✅               | ❌ \*            | ✅               |
| 🚀 Performance                                    | Fast             | Slow             | Average          |
| 🕒 Timezone support                               | ✅               | ✅               | ✅               |
| 🌍 Geo IP support                                 | ✅               | ✅               | ✅               |
| 👐 Open source                                    | ✅               | ❌               | ❌               |
| 💼 Commercial use                                 | ✅               | ❌               | ✅               |
| 🔄 Backwards compatible with worldtimeapi.org API | ✅               | n/a              | ❌               |
| 📝 Response formats                               | JSON, plain text | JSON, plain text | JSON             |

\* has been down multiple times in the past, and still suffers from occasional 'connection reset' errors.

## Roadmap

A couple of features that are planned for the future:

- [ ] Provide additional geolocation data API endpoints (coordinates, country, city, etc.). We have the data, just not the API endpoints.
- [ ] IPV6 support. Our database already supports this, we just need to import the relevant dataset and update the API documentation accordingly.
- [Suggest a feature!](https://github.com/sleeyax/world-time-api/issues?q=sort%3Aupdated-desc+is%3Aissue+is%3Aopen)

## Data Sources

We use the following open data sources to provide accurate timezone information:

- Timezone data from [IANA timezone database](https://www.iana.org/time-zones)
- Geo IP data from [maxmind geolite2](https://dev.maxmind.com/geoip/geolite2-free-geolocation-data/)

Both are standards in the industry and are updated regularly to reflect changes in timezones and IP geolocation data.

## API Endpoints

The API follows the World Time API specification with the following endpoints:

### Timezone Endpoints

- `GET /api/timezone` - List all available timezones (JSON)
- `GET /api/timezone.txt` - List all available timezones (plain text)
- `GET /api/timezone/{area}` - List timezones for specific area (JSON)
- `GET /api/timezone/{area}.txt` - List timezones for specific area (plain text)
- `GET /api/timezone/{area}/{location}` - Get current time for location (JSON)
- `GET /api/timezone/{area}/{location}.txt` - Get current time for location (plain text)
- `GET /api/timezone/{area}/{location}/{region}` - Get current time for region (JSON)
- `GET /api/timezone/{area}/{location}/{region}.txt` - Get current time for region (plain text)

### IP-based Endpoints

- `GET /api/ip` - Get time based on client IP (JSON)
- `GET /api/ip.txt` - Get time based on client IP (plain text)
- `GET /api/ip/{ipv4}` - Get time based on specific IP (JSON)
- `GET /api/ip/{ipv4}.txt` - Get time based on specific IP (plain text)

## Response Formats

### DateTime

JSON:

```json
{
  "utc_offset": "-04:00",
  "timezone": "America/New_York",
  "day_of_week": 6,
  "day_of_year": 214,
  "datetime": "2025-08-02T13:02:11.703-04:00",
  "utc_datetime": "2025-08-02T17:02:11.703+00:00",
  "unixtime": 1754154131,
  "raw_offset": -18000,
  "week_number": 31,
  "dst": true,
  "abbreviation": "EDT",
  "dst_offset": 3600,
  "dst_from": "2025-03-09T07:00:00+00:00",
  "dst_until": "2025-11-02T06:00:00+00:00",
  "client_ip": "127.0.0.1"
}
```

Plain Text:

```
utc_offset: -04:00
timezone: America/New_York
day_of_week: 6
day_of_year: 214
datetime: 2025-08-02T13:02:51.390-04:00
utc_datetime: 2025-08-02T17:02:51.390+00:00
unixtime: 1754154171
raw_offset: -18000
week_number: 31
dst: true
abbreviation: EDT
dst_offset: 3600
dst_from: 2025-03-09T07:00:00+00:00
dst_until: 2025-11-02T06:00:00+00:00
client_ip: 127.0.0.1
```

## Contribute

See our [GitHub repository](https://github.com/sleeyax/world-time-api).


Get local time for any timezone or IP address. JSON or plain text output. Free 20000 calls/mo, from $5/mo. Start free on API.market.

World Time – Timezone & IP Lookup | Free · $5/mo | API.market