Public API
Free calendar data API
Static JSON for US & world public holidays, FOMC meeting dates, sports schedules and finance calendars. HTTPS, CORS-open, no authentication, no rate limit.
Quick start
curl https://the-calendar.net/api/holidays/us-federal/2026.jsonSample endpoints
/api/holidays/us-federal/2025.json— US Federal Holidays 2025/api/holidays/us-federal/2026.json— US Federal Holidays 2026/api/holidays/us-federal/2027.json— US Federal Holidays 2027/api/holidays/us-federal/2028.json— US Federal Holidays 2028/api/holidays/by-state/alabama/2026.json— Alabama Holidays 2026/api/holidays/by-state/alaska/2026.json— Alaska Holidays 2026/api/holidays/by-state/arizona/2026.json— Arizona Holidays 2026/api/holidays/by-state/arkansas/2026.json— Arkansas Holidays 2026
99 endpoints total. See the complete machine-readable list at /api/index.json.
Categories
- Holidays — US federal (2025–2028), all 50 US states (2026), 30 countries (2026)
- Finance — FOMC meetings, US tax deadlines, US stock market holidays (2026)
- Sports — key dates for 12 leagues (NFL, NBA, MLB, NHL, MLS, Premier League, La Liga, UCL, F1, Real Madrid, FC Barcelona, Manchester United)
Response shape
{
"country": "US",
"kind": "federal",
"year": 2026,
"source": "5 U.S.C. § 6103",
"holidays": [
{ "name": "New Year's Day", "date": "2026-01-01", "observed": null, "weekday": "Thursday", "note": null }
]
}Terms
Licence: CC BY 4.0. Attribution: link back to the-calendar.net. No authentication, no rate limit, CORS open (Access-Control-Allow-Origin: *). Also available as downloadable .ics calendars.