About

clocknow API

Every answer says how it was made: meta.error_bound_ms, meta.tzdata_version and meta.server_id. If the server clock has not been measured, the error bound is null rather than a made-up number.

Try it

No key needed for the open endpoints (10,000 requests a month per IP):

curl "https://api.clocknow.net/v1/convert?from=Asia/Karachi&to=America/New_York&time=2026-11-07T12:00"

Get a free key

A key unlocks the astronomy endpoints and gives you your own request counter instead of sharing your IP's.

Already have an account? Manage your keys and passkeys.

curl "https://api.clocknow.net/v1/sun?lat=24.86&lon=67&date=2026-11-07" \
  -H "Authorization: Bearer ck_live_…"

Endpoints

PathWhat it returnsAccess
/v1/nowServer time for clock sync, optionally with a zoneOpen
/v1/zoneTime, offset, abbreviation and next change in a zoneOpen
/v1/convertA wall time in one zone shown in anotherOpen
/v1/differenceOffset difference between two zonesOpen
/v1/calendar/convertOne date shown in Gregorian, Hijri, Hebrew, Chinese, Persian, Indian, ISO week and Julian DayOpen
/v1/print/month, /v1/print/yearPrintable calendar as a PDF: A4 or Letter, English, Arabic or Urdu, optional Hijri datesKey
/v1/signedEd25519-signed timestamp you can verify offlineOpen
/v1/sun, /v1/moon, /v1/seasonsAstronomy computed by the same Rust coreKey

Full reference: openapi.json (OpenAPI 3.1; import it into Postman, Insomnia or a client generator).

Limits

Requests are counted per calendar month (UTC). Past the limit you get 429 with Retry-After in seconds; X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset are on every response. Paid tiers with higher limits are not open yet.

Please credit clocknow.net when you show our data to your users.

Tap anywhere for fullscreen