Public holidays by country

$0.003 per call · failed calls are never charged · no account or API key needed

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.

Run it free (25 free calls) Buy credits by card (from $5) Example result (JSON)

Inputs

NameTypeDescription
country (required)stringISO 3166-1 alpha-2 code: US, GB, SE, DE, FR, NO, DK or FI
yearintegerYear, 2024-2100 (default this year)

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/holidays?country=SE"

Or one of your 25 free calls, no key:

curl "https://agent-data-tools.revmesh2074.workers.dev/holidays?country=SE&trial=1"

Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum, Monad, World Chain or Tempo) and retries.

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."
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is holidays, and the first 25 successful calls are free:

https://agent-data-tools.revmesh2074.workers.dev/mcp

Related tools