# Public holidays API

Nationwide public holidays for a year in the US (federal), UK (England and Wales), Sweden, Germany, France, Norway, Denmark and Finland: date, local and English name, and the weekday it is observed on where a weekend moves it. Computed from statutory rules for 2024-2100. Use for scheduling, delivery dates and business-day maths.

## When an agent wants this

- List a country's public holidays for scheduling
- Skip holidays when planning deliveries or meetings

## Public holidays by country: list a country's public holidays for a year

Public holidays by country: list a country's public holidays for a year. $0.01 per successful call; failed calls are never charged.

Nationwide public holidays for a year in the US (federal), UK (England and Wales), Sweden, Germany, France, Norway, Denmark and Finland: date, local and English name, and the weekday it is observed on where a weekend moves it. Computed from statutory rules for 2024-2100. Use for scheduling, delivery dates and business-day maths.

Inputs: country (required): ISO 3166-1 alpha-2 code: US, GB (UK), SE, DE, FR, NO, DK or FI; English country names also work; year: Year, 2024-2100 (default this year).

Free first (25 successful calls per caller, no key):

    curl "https://tools.funwords.eu/holidays?country=SE&trial=1"

With a card key from https://tools.funwords.eu/credits, in a header or, when your client can only fetch a URL, in the URL:

    curl -H "Authorization: Bearer adt_…" "https://tools.funwords.eu/holidays?country=SE"
    curl "https://tools.funwords.eu/holidays?country=SE&api_key=adt_…"

Without a key the same URL answers 402 with x402 and MPP terms, so a wallet client pays USDC per call and retries. Over MCP (https://tools.funwords.eu/mcp) this tool is holidays.

Example result:

    {
      "country": "SE",
      "countryName": "Sweden",
      "year": 2026,
      "count": 13,
      "holidays": [
        {
          "date": "2026-01-01",
          "localName": "Nyårsdagen",
          "name": "New Year's Day",
          "nationwide": true,
          "types": [
            "Public"
          ],
          "observed": null
        }
      ],
      "note": "Computed from statutory rules; nationwide holidays only. Regional holidays and one-off proclamations are not included."
    }

Tool page: https://tools.funwords.eu/tools/holidays

## Business days between dates, working days calculator: count working days between two dates, skipping weekends and public holidays

Business days between dates, working days calculator: count working days between two dates, skipping weekends and public holidays. $0.01 per successful call; failed calls are never charged.

Count business (working) days between two dates, skipping weekends and public holidays for the US, UK, Sweden, Germany, France, Norway, Denmark or Finland, and list the holidays skipped; or give add=N to get the date N business days after (or before) a date. Other countries count weekends only, and the answer says so. Use for delivery estimates, SLAs, payment terms and payroll dates.

Inputs: from (required): Start date, YYYY-MM-DD; to: End date, YYYY-MM-DD (inclusive; default: the last day of the start month); or use add; add: Business days to add to from (negative to go back), instead of to; country: Holiday calendar: US, GB, SE, DE, FR, NO, DK or FI (default: weekends only).

Free first (25 successful calls per caller, no key):

    curl "https://tools.funwords.eu/date/business-days?from=2026-12-01&trial=1"

With a card key from https://tools.funwords.eu/credits, in a header or, when your client can only fetch a URL, in the URL:

    curl -H "Authorization: Bearer adt_…" "https://tools.funwords.eu/date/business-days?from=2026-12-01"
    curl "https://tools.funwords.eu/date/business-days?from=2026-12-01&api_key=adt_…"

Without a key the same URL answers 402 with x402 and MPP terms, so a wallet client pays USDC per call and retries. Over MCP (https://tools.funwords.eu/mcp) this tool is date_business_days.

Example result:

    {
      "from": "2026-12-01",
      "to": "2026-12-31",
      "country": "SE",
      "holidayRules": true,
      "calendarDays": 31,
      "businessDays": 20,
      "weekendDays": 8,
      "holidays": [
        {
          "date": "2026-12-24",
          "name": "Christmas Eve"
        }
      ]
    }

Tool page: https://tools.funwords.eu/tools/date-business-days

## Questions

Docs for agents: https://tools.funwords.eu/llms.txt · OpenAPI: https://tools.funwords.eu/openapi.json · All guides: https://tools.funwords.eu/guides