Time Zone API docs
Current time, UTC offset, DST status and abbreviation for any IANA time zone, plus zone-to-zone datetime conversion. Always accurate, no external dependency.
Authentication
All Time Zone API requests authenticate via two headers. Get your API key from your RapidAPI dashboard after subscribing on the Basic (free) tier or higher.
X-RapidAPI-Key: YOUR_API_KEY X-RapidAPI-Host: timezone-by-helix-api.p.rapidapi.com
Base URL
https://timezone-by-helix-api.p.rapidapi.com
Endpoints
GET
/lookupCurrent time and details for a time zone
GET
/convertConvert a datetime between time zones
GET
/listList supported IANA time zones
Code Examples
Python
import requests
url = "https://timezone-by-helix-api.p.rapidapi.com/lookup"
headers = {
"X-RapidAPI-Key": "YOUR_API_KEY",
"X-RapidAPI-Host": "timezone-by-helix-api.p.rapidapi.com",
}
response = requests.get(url, headers=headers)
print(response.json())JavaScript
const response = await fetch(
"https://timezone-by-helix-api.p.rapidapi.com/lookup",
{
method: "GET",
headers: {
"X-RapidAPI-Key": "YOUR_API_KEY",
"X-RapidAPI-Host": "timezone-by-helix-api.p.rapidapi.com"
}
}
);
const data = await response.json();cURL
curl -X GET "https://timezone-by-helix-api.p.rapidapi.com/lookup" \ -H "X-RapidAPI-Key: YOUR_API_KEY" \ -H "X-RapidAPI-Host: timezone-by-helix-api.p.rapidapi.com"
Response Format
All endpoints return JSON in this consistent envelope:
{
"status": "ok",
"data": { /* endpoint-specific payload */ },
"meta": {
"cached": false,
"latency_ms": 142,
"request_id": "req_abc123"
},
"timestamp": "2026-05-21T12:00:00Z"
}Error Codes
| HTTP | Code | Meaning |
|---|---|---|
| 400 | BAD_REQUEST | Missing or invalid parameter |
| 401 | UNAUTHORIZED | Invalid or missing API key |
| 403 | FORBIDDEN | Your plan doesn't include this endpoint |
| 429 | RATE_LIMIT_EXCEEDED | Too many requests — back off and retry |
| 500 | INTERNAL_ERROR | Something went wrong on our side |
| 503 | UPSTREAM_UNAVAILABLE | A third-party data source is down |
Common Use Cases
Meeting schedulers
Global SaaS apps
Travel apps
Log normalization
Calendar tools
International team standup planner
Cron job timezone scheduling
Flight itinerary timezone display
Customer support hours display
Live event countdown timer
Multi-timezone dashboard clock
Webinar scheduling across regions
Delivery ETA timezone conversion
Remote employee work hours tracker
Financial market hours display
Podcast release time scheduling
Social media post scheduling
Server maintenance window planner
International exam scheduling
Sports broadcast time converter