TimeNumbersA more connected world
REST v1 Specification

World Time & Chronometry API Docs (v1)

Free, low-latency REST API documentation for live world time, IANA timezones, UTC offsets, and solar ephemeris calculations. Zero keys required.

API Key Sandbox

Test rate limits and authentication tiers in real-time.

Active Key:(None - Anonymous)
REST Endpoints (v1)
GET/api/v1/time

Current Atomic UTC Time & Timestamps

Returns the current international atomic time standard (UTC), ISO 8601 string, UNIX timestamps (seconds and milliseconds), day of year, week number, and leap year flags.

Example Response Schema

Content-Type: application/json
{
  "status": "success",
  "data": {
    "standard": "Coordinated Universal Time (UTC)",
    "iso8601": "2026-10-08T16:30:00.000Z",
    "timestamp": 1791477000,
    "timestampMs": 1791477000000,
    "year": 2026,
    "month": 10,
    "day": 8,
    "hours": 16,
    "minutes": 30,
    "seconds": 0,
    "dayOfWeek": "Thursday",
    "dayOfYear": 281,
    "weekNumber": 41,
    "isLeapYear": false,
    "utcOffset": "+00:00",
    "abbreviation": "UTC"
  },
  "rateLimit": {
    "tier": "free",
    "tierName": "Free Starter",
    "limitPerMinute": 10,
    "remainingThisMinute": 9,
    "resetSeconds": 60
  }
}
Transparent Commercial Pricing

High-Throughput Time Infrastructure for Modern Teams

Scale seamlessly from local development to mission-critical enterprise microservices with guaranteed SLAs and accurate IANA timezone datasets.

Free Starter

Perfect for development, personal scripts, and prototype validation.

₹0/ month
3,000 requests / month
10 req/min burst rate
  • 3,000 requests per month
  • 10 requests per minute
  • UTC, timezones & location endpoints
  • Community documentation & samples
  • No credit card required
Most Popular

Developer Pro

Designed for production mobile apps, SaaS integrations, and cron jobs.

₹399/ month
approx. $5 USD / mo
50,000 requests / month
60 req/min burst rate
  • 50,000 requests per month
  • 60 requests per minute (1 req/sec burst)
  • Solar, astronomical & moon phase endpoints
  • Timezone conversion & meeting overlap matrix
  • Email developer support within 24h
  • Commercial production license

Business Scale

High-throughput infrastructure for multinational enterprise scheduling & logistics.

₹1,999/ month
approx. $25 USD / mo
500,000 requests / month
300 req/min burst rate
  • 500,000 requests per month
  • 300 requests per minute burst capacity
  • 99.9% Uptime SLA guarantee
  • Multi-city parallel batch calculation
  • Dedicated edge caching & zero-latency routes
  • Priority horology engineering escalation

Enterprise Custom

Custom contract, bespoke quotas, on-premises docker containers, or dedicated cloud routing.

₹7,999/ month
approx. $99 USD / mo
5,000,000 requests / month
1200 req/min burst rate
  • 5,000,000+ requests per month
  • Custom rate limits & dedicated IPs
  • 99.99% Enterprise SLA
  • Dedicated account manager
  • Custom timezone data ingestion
  • Invoiced payment & signed DPA

Endpoints for City Time, Timezones, and Coordinates

Integrate live atomic timestamps, municipal local clocks, and solar calculations into your applications. The TimeNumbers REST API provides high-throughput, edge-cached endpoints powered by canonical IANA tzdata.

Review complete request and response schemas, test live queries with our interactive playground, and integrate world time directly into web apps, CLI utilities, and IoT hardware.

Astronomical and Solar Ephemeris Payloads

Canonical IANA tzdata, astronomical ephemeris formulas, and edge CDN cache headers.

Rate Limiting, CORS Headers, and Edge Caching

Canonical IANA tzdata, astronomical ephemeris formulas, and edge CDN cache headers.

Frequently Asked Questions: REST API Integration

Common queries, time calculations, and scientific explanations

No. The public v1 endpoints are open and free with no sign-up or authorization keys needed for normal development and integration.

Explore More Developer Tools & Clocks

Quick access to international capitals, timezone offsets, chronometry tools, and horology guides

Precision Horology & Global Time Tools

City Time Differences Directory
Exact hours ahead & overlap for 92+ city pairs
Coordinated Universal Time (UTC)
Canonical atomic reference standard and UTC offset zero
Multi-Zone Time Converter Hub
Convert hours across global zones and cities
Compare World Cities
Direct side-by-side time difference and overlap
United States Time Now
Live atomic clocks across all US time zones and Washington D.C.
Exact Time Digital Clock
Precision digital chronometer with seconds and atomic reference
Online Pomodoro Timer
25/5 study and deep work productivity intervals
Accurate Analog Clock
Smooth sweeping second hand and Swiss watch dial
552 Timezone Converters
Visual timeline converter across 552 global timezone pairs
Date Difference Calculator
Exact days, weeks, months & business days between dates
Date Calculator
Add or subtract days, weeks, months & business days
Golden Hour Calculator
Exact photography lighting, blue hour & civil twilight times
Sunrise & Sunset Times Hub
NOAA algorithm solar dawn and dusk times worldwide
Moon Phases & Illumination
Live lunar surface illumination % and 29.5-day synodic cycle
Interactive World Time Map
Real-time solar terminator, day/night zones & 46 live clocks
400+ Time Zones Directory
Complete canonical IANA database with live ticking clocks
Interactive Timezone Map
Live global clock bands with clickable UTC offset zones
World Cities Directory
Current local time and population across global metropolises
Today's Date Details
Day of year, ISO week, Julian day & year progress percentage
ISO Week Number Calculator
Current ISO week number, calendar quarters & weeks remaining
ISO 8601 String Parser
Parse, validate and format ISO-8601 date-time strings
Unix Timestamp Converter
Epoch seconds converter to human readable UTC & local time
Astronomy & Twilight Lab
Sunrise, sunset, golden hour & moon phase calendar
International Dialing Codes
Country calling codes & smart calling hour guide
Multi-Clock World Wall
Trading floor kiosk with Swiss analog & digital dials
Flight & Jet Lag Calculator
Travel time & circadian light adjustment protocol
Online Alarm Clock
Fullscreen bedside display with Web Audio chimes
Meeting Planner
Overlap working window across 4+ global hubs
Team Overlap Calculator
Mutual working hours matrix for remote teams
Business Days Calculator
Working days between dates & 90-day deadlines
Birthday & Age Countdown
Weeks, days & exact chronological age tracker
Atomic Clock Accuracy
NTP drift latency benchmark
Unix Timestamp Studio
Epoch seconds converter & 2038 lab
Military Time Converter & Chart
Convert 12h to 24h military time with spoken pronunciation & printable chart
Work Hours & Timesheet Calculator
Calculate weekly hours, lunch deductions, overtime pay & gross wages
Best Time to Call Calculator
Find overlapping daytime calling window between international cities
Time Zone VS Comparisons
Head-to-head differences (CST vs EST, PST vs MST, GMT vs UTC)
Daylight Saving Schedule
Global spring forward & fall back dates
Horology Learning Academy
Deep dive into UTC, leap seconds & chronometry
SEO Authority Simulator
Interactive DA vs Keyword Difficulty ranking simulator