caldays
Developer API

Calendars & holidays, as a JSON endpoint.

Free for fair use (10,000 requests/day). Holidays for 195 countries, real-time, CDN-cached. No API key required for read endpoints.

Primary endpoint

Holidays per country.

Returns an array of holidays for one country in one year. Type = "national", "joint", or "regional".

GET https://api.caldays.com/v1/us/holidays/2026
[
{ "date": "2026-01-01", "name": "New Year's Day", "type": "national" },
{ "date": "2026-07-04", "name": "Independence Day", "type": "national" },
]
Long-weekend endpoint

Automatic bridge planner.

GET https://api.caldays.com/v1/us/long-weekends/2026
[
{ "start": "2026-07-03", "end": "2026-07-05",
"totalDays": 3, "bridge": 0, "label": "Independence Day" },
]
Time-zone endpoint

Conversion & comparison.

GET https://api.caldays.com/v1/clock?cities=jkt,sgp,tyo,lon
Limits & support

Fair and accountable.

10,000 requests per IP per day. For higher volume: commercial tier $29/month (100k/day) or $199/month (10M/day) with no per-IP rate-limit. No lock-in, cancel anytime.

Attribution

Free, in exchange for a credit.

The caldays holiday dataset is released under Creative Commons Attribution 4.0. You can use it commercially, redistribute it, or build paid products on top of it — we only ask that you credit caldays with a visible link, e.g. "Holiday data: caldays.com" in your footer, about page, or API response.

<!-- Suggested attribution snippet -->
<p>Public holiday data powered by
<a href="https://caldays.com" target="_blank" rel="noopener">caldays</a>
(<a href="https://creativecommons.org/licenses/by/4.0/">CC BY 4.0</a>).
</p>
Developer
Get an API key