Timezone API

Current time, conversion, DST, sunrise/sunset for 1029 cities. Free tier, one API key, 7 endpoints.

Get API Key on RapidAPI Free tier available. No credit card required.

Quick start

curl -H "Authorization: Bearer witt_YOUR_KEY" \
  https://api.whatisthetime.now/api/v1/time/tokyo
{
  "ok": true,
  "data": {
    "city": { "slug": "tokyo", "name": "Tokyo", "country": "Japan" },
    "time": {
      "formatted24": "20:30:00",
      "formatted12": "8:30:00 PM",
      "date": "Thursday, March 26, 2026"
    },
    "timezone": {
      "iana": "Asia/Tokyo",
      "utcOffset": "+09:00",
      "isDST": false
    }
  }
}

Endpoints

GET /api/v1/time/:city

Current time in a city

GET /api/v1/convert

Convert time between cities

GET /api/v1/compare/:city1/:city2

Time difference + business hours overlap

GET /api/v1/dst/:country

DST status and transition dates

GET /api/v1/sunrise/:city

Sunrise, sunset, day length

GET /api/v1/timezone/Asia/Tokyo

Timezone metadata by IANA identifier

GET /api/v1/search?q=cop

Fuzzy city search

Pricing

Basic $0
  • 1,000 requests/month
  • 30 requests/minute
  • All 7 endpoints
  • 1029 cities
Pro Pay per use
  • $0.002 per request
  • 300 requests/minute
  • All 7 endpoints
  • Pay only for what you use
Ultra $39/mo
  • 200,000 requests/month
  • 600 requests/minute
  • All 7 endpoints
  • Priority support
Mega $69/mo
  • 1,000,000 requests/month
  • 1,000 requests/minute
  • All 7 endpoints
  • Priority email support

Frequently Asked Questions

Is the API free?

Yes. The free plan includes 1,000 requests per month. Paid plans start at $0.002 per request (pay as you go) or $39/month for 200,000 requests.

How do I get an API key?

Sign up on RapidAPI to get your key instantly. RapidAPI handles authentication, billing, and usage tracking.

What data format is returned?

All responses are JSON with a consistent envelope: { ok: true/false, data: {...}, meta: { requestId, timestamp } }. Errors include a code and human-readable message.

How many cities are covered?

The API covers 1029 cities across all IANA timezone zones. Use the search endpoint to find any city by name.

Is there rate limiting?

Yes. Free: 30 req/min. Pro: 300 req/min. Ultra: 600 req/min. Mega: 1,000 req/min. Rate limit headers are included on every response.