the-calendar.net

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.

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" frameborder="0" loading="lazy" title="Week Number Calculator"></iframe>

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" frameborder="0" loading="lazy" title="Days Between Dates"></iframe>

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" frameborder="0" loading="lazy" title="Countdown Timer"></iframe>

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" frameborder="0" loading="lazy" title="Age Calculator"></iframe>

Downloadable .ics calendars

Drop into Google Calendar, Apple Calendar, Outlook, or any iCal-compatible app. Subscribe via the file URL for auto-updates (re-download annually for new holiday years).

US holidays

US holidays by state (2026)

One file per state combining the 11 federal holidays with state-specific paid holidays.

Browse the by-state index — each state page has a direct download link.

Country holidays (2026)

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.

Browse the by-country index for individual downloads.

Finance & sports

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/2026.json
GET https://the-calendar.net/api/holidays/by-country/germany/2026.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.