Public holidays for a year

List the public holidays of one year for a country or subdivision. With region "list", return every supported region code.

CHF 0.002 / callCall it Try it

Portable diptych sundial1518

Details

Covers: 2000–2035; CH (26 cantons), DE (16 states), AT (9 states), FR (+ Alsace, Moselle), IT, LI, GB (4 nations), ES (regions), US (states) and 23 more European countries.

Names are in English.

Price: CHF 0.002 per call (first 100 calls per day free).

Example: {"region":"CH-TI","year":2026} → 15 holidays, including Saints Peter and Paul on 2026-06-29.

Call it

REST

curl -X POST https://api.tausendwerk.xyz/v1/holidays \
  -H "Content-Type: application/json" \
  -d '{"region":"CH-TI","year":2026}'

MCP tool name

holidays

After the free 100 calls per day, add a key: Authorization: Bearer tw_live_…. Pricing

Try it

Runs against the live API with the free allowance.

Input (JSON)

Input schema JSON Schema

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "region"
  ],
  "properties": {
    "region": {
      "type": "string",
      "pattern": "^([A-Z]{2}(-[A-Z0-9]{1,3})?|list)$",
      "description": "Region code, or \"list\" for all codes"
    },
    "year": {
      "type": "integer",
      "minimum": 2000,
      "maximum": 2035
    }
  },
  "examples": [
    {
      "region": "CH-TI",
      "year": 2026
    }
  ]
}

More in Dates and deadlines

Business days between two datesCount the business days between two dates for a country or subdivision, and list the public holidays skipped.CHF 0.002 / call Deadline in business daysReturn the date that is N business days after (or before, with a negative N) a start date, for a country or subdivision.CHF 0.002 / call Is this a business day?Say whether a date is a business day in a country or subdivision, and why not if it is not.CHF 0.001 / call