Timezone API

Current time, conversion, DST, sunrise/sunset for 990 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
  • 990 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
Proton VPN Proton VPN Proton VPN Proton VPN Proton VPN Proton VPN

FAQ

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 990 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.