TimeandTool API

Free REST API for time & date data. 1,000 requests/day on the free tier.

Authentication

Include your API key in the Authorization header:

Authorization: Bearer ct_live_your_api_key_here

GET/api/v1/holidays

Get public holidays for a country and year.

Parameters: country (ISO 2-letter), year

/api/v1/holidays?country=US&year=2026

GET/api/v1/timezone

Get current time and offset for a timezone.

Parameters: tz (IANA timezone string)

/api/v1/timezone?tz=America/New_York

GET/api/v1/date/diff

Calculate difference between two dates.

Parameters: from (ISO date), to (ISO date)

/api/v1/date/diff?from=2026-01-01&to=2026-12-31

GET/api/v1/sun

Get sunrise and sunset times for a location.

Parameters: lat, lng, date (ISO date)

/api/v1/sun?lat=40.7128&lng=-74.0060&date=2026-06-21