Developers

Embeds, .ics downloads, and a free JSON API.

Use our calendar tools, holiday data, and event feeds in your own projects. Everything is free with attribution.

Embed our widgets

Each widget is a self-contained iframe with no tracking. Paste the snippet into any HTML page.

Is Today a Holiday?

Today's US holiday status and the next holidays. Add ?state=texas (any state slug) to the iframe URL for one state's office closures.

Live preview

Embed code

<iframe src="https://the-calendar.net/embed/is-today-a-holiday/" width="100%" height="460" style="border:0" loading="lazy" title="Is Today a Holiday?"></iframe>
<p style="font:13px/1.4 system-ui,sans-serif;margin:4px 0 0">Is Today a Holiday? by <a href="https://the-calendar.net/tools/is-today-a-holiday/">the-calendar.net</a></p>

Free to use. Please keep the one-line credit under the widget.

Week Number Calculator

ISO week number for any date — week 1–53 with ISO-year handling.

Live preview

Embed code

<iframe src="https://the-calendar.net/embed/week-number/" width="100%" height="280" style="border:0" loading="lazy" title="Week Number Calculator"></iframe>
<p style="font:13px/1.4 system-ui,sans-serif;margin:4px 0 0">Week Number Calculator by <a href="https://the-calendar.net/tools/week-number/">the-calendar.net</a></p>

Free to use. Please keep the one-line credit under the widget.

Days Between Dates

Days, weeks, and business days between two dates.

Live preview

Embed code

<iframe src="https://the-calendar.net/embed/days-between/" width="100%" height="280" style="border:0" loading="lazy" title="Days Between Dates"></iframe>
<p style="font:13px/1.4 system-ui,sans-serif;margin:4px 0 0">Days Between Dates by <a href="https://the-calendar.net/tools/days-between/">the-calendar.net</a></p>

Free to use. Please keep the one-line credit under the widget.

Countdown Timer

Live ticking countdown to a target date.

Live preview

Embed code

<iframe src="https://the-calendar.net/embed/countdown/" width="100%" height="260" style="border:0" loading="lazy" title="Countdown Timer"></iframe>
<p style="font:13px/1.4 system-ui,sans-serif;margin:4px 0 0">Countdown Timer by <a href="https://the-calendar.net/tools/countdown/">the-calendar.net</a></p>

Free to use. Please keep the one-line credit under the widget.

Age Calculator

Exact age in years, months, days.

Live preview

Embed code

<iframe src="https://the-calendar.net/embed/age-calculator/" width="100%" height="240" style="border:0" loading="lazy" title="Age Calculator"></iframe>
<p style="font:13px/1.4 system-ui,sans-serif;margin:4px 0 0">Age Calculator by <a href="https://the-calendar.net/tools/age-calculator/">the-calendar.net</a></p>

Free to use. Please keep the one-line credit under the widget.

Downloadable .ics calendars

Drop into Google Calendar, Apple Calendar, Outlook, Nextcloud, Home Assistant or any iCal-compatible app. The subscription feeds have one stable URL per calendar and cover several years, so subscribe once (webcal:// or the https URL) and new years arrive automatically. Single-year files remain available for one-off imports.

US holidays

US holidays by state (2026–2028)

One subscription feed per state combining the 11 federal holidays with state-specific paid holidays: /downloads/states/<state>-holidays.ics, e.g. texas-holidays.ics, california-holidays.ics. Yearly files: <state>-holidays-2026.ics … -2028.ics.

Browse the by-state index — each state page has subscribe and download links.

Country holidays (2026–2028)

Public holidays for 30 countries: UK, Canada, Australia, Germany, France, Spain, Italy, India, Japan, Mexico, Brazil, China, South Korea, Singapore, UAE, Saudi Arabia, Israel, Turkey, South Africa, Argentina, Chile, Colombia, Poland, Sweden, Norway, Denmark, Finland, Switzerland, Ireland, Netherlands.

Subscription feed per country: /downloads/countries/<country>-holidays.ics, e.g. united-kingdom-holidays.ics, germany-holidays.ics. Yearly files: <country>-holidays-2026.ics … -2028.ics.

Browse the by-country index for individual links.

Finance & sports

Versioned dataset: the verified US federal and state holiday data, with sources, as CSV/JSON on GitHub.

JSON API

Free, static JSON endpoints served from our CDN. CORS-open. No authentication, no rate limit.

Examples

GET https://the-calendar.net/api/holidays/us-federal/2026.json
GET https://the-calendar.net/api/holidays/by-state/california/2027.json
GET https://the-calendar.net/api/holidays/by-country/germany/2028.json
GET https://the-calendar.net/api/finance/fomc/2026.json
GET https://the-calendar.net/api/sports/nfl-schedule.json

Full endpoint list: /api/index.json

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
    }
  ]
}

Licence & attribution

Data and widgets: CC BY 4.0. Include a link to the-calendar.net wherever you use them. We don't require an exact phrase — anything obvious like "Calendar data by the-calendar.net" is fine.

Found a bug or have a feature request? Get in touch.