Public Holidays by Country and Year

API ↗

Public Holidays by Country and Year is a paid API for AI agents from x402-catalog-history.ai-business-surface.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-18).

Returns all public holidays for a given country and year, including dates, local and English names, types, weekday, and days-from-today offsets, sourced live from Nager.Date.

How this service works

Public holidays for one country and year in one GET: the date, the local-language name, the English name, the types, the weekday and how many days from today each one falls. curl: GET /holidays?country=JP&year=2026 (country is a two-letter ISO 3166-1 code; year defaults to this year). Response: {"country":"JP","year":2026,"count":16,"holidays":[{"date":"2026-01-01","local_name":"元日","name":"New Year's Day","types":["Public"],"weekday":"Thursday","global":true,"days_from_today":-290}],"upcoming":[...],"source":{"name":"Nager.Date","api":"https://date.nager.at/api/v3/PublicHolidays","fetched_at":"…"}}. Every value is read from the Nager.Date public API at the moment of the call, and the response carries the API URL and the fetched_at it came from. 0.003 USDC, no account, no key, one GET, one delivery. A purchase is two calls by design: this first call returns 402 with the price and the payment terms, and you then repeat the same request with the PAYMENT-SIGNATURE header to receive the 200 delivery.

Output

A JSON object with the country code, year, total holiday count, a full list of holidays (each with date, local_name, English name, types array, weekday, global flag, and days_from_today), an upcoming holidays subset, and a source block naming Nager.Date with the API URL and fetched_at timestamp.