{"uid":"cap_AeoSsKgFIHBpBepHs5-Vk","slug":"402utils-holiday-api-36a1e4b2","name":"402utils Holiday API","description":"Public and bank holidays for FR, DE, GB, US, ES, IT, NL, BE — years 2025-2027, each dataset verified against the country's official source (Etalab, Land statutes, gov.uk feed, OPM, BOE, normattiva, rijksoverheid, SPF Emploi). Movable feasts are computed (Gregorian computus), substitute days follow each country's official rule. Optional ?region= for sub-national holidays (German Länder, UK divisions, Alsace-Moselle).","url":"https://402utils.com/v1/holidays?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["country","year"],"properties":{"year":{"type":"integer","description":"2025-2027 (verified data window)."},"region":{"type":"string","description":"Optional ISO 3166-2 region for regional holidays (e.g. DE-BY, GB-SCT, FR-57)."},"country":{"type":"string","description":"ISO 3166-1 alpha-2: FR, DE, GB, US, ES, IT, NL, BE."}},"description":"Query params. `country` and `year` required."}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["country","year","holidays"],"properties":{"note":{"type":"string","description":"Dataset-level caveat when applicable."},"year":{"type":"integer"},"region":{"type":"string"},"country":{"type":"string"},"holidays":{"type":"array","items":{"type":"object","required":["date","name","localName","type"],"properties":{"date":{"type":"string","description":"YYYY-MM-DD."},"name":{"type":"string","description":"English name."},"note":{"type":"string"},"type":{"type":"string","description":"public | bank | observance."},"regions":{"type":"array","items":{"type":"string"},"description":"Present when the holiday is regional."},"localName":{"type":"string"}}}}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"year":2026,"country":"FR","holidays":[{"date":"2026-01-01","name":"New Year's Day","type":"public","localName":"Jour de l'an"},{"date":"2026-04-06","name":"Easter Monday","type":"public","localName":"Lundi de Pâques"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":{"p10Cents":"0.2000","medianCents":"0.2000","p90Cents":"0.2000","minCents":"0.2000","maxCents":"0.2000","p95Cents":"0.2000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UnrNV_pB0TbUTdBcJ-emb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns verified public and bank holidays for 8 countries (FR, DE, GB, US, ES, IT, NL, BE) for years 2025–2027, with optional sub-national region support","exampleAgentPrompt":"Can you get me a list of all official public holidays in Germany for 2025, including regional ones for Bavaria (DE-BY)?","exampleUseCases":null,"resultDescription":"A JSON object containing the country code, year, optional region, and an array of holiday objects — each with date (YYYY-MM-DD), English name, local name, type (public/bank/observance), optional regional applicability array, and optional dataset-level notes. Data is verified against each country's official source.","failureModes":["Unsupported country code returns an error — only FR, DE, GB, US, ES, IT, NL, BE are supported","Year outside 2025–2027 range returns an error — no historical or future data beyond verified window","Invalid or unrecognized region code may return an error or fall back to national holidays","Missing required query parameters (country or year) returns a 400-level error","Payment failure (x402) returns a 402 status if USDC payment is not completed"],"whenToPreferThis":"Choose this endpoint when you need authoritative, government-source-verified holiday data for one of the 8 supported European/US countries in years 2025–2027, especially when you need sub-national precision (German Länder, UK divisions, Alsace-Moselle). Prefer it over generic calendar APIs when accuracy against official sources and movable feast computation correctness matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:40:10.689Z","isFirstParty":false,"canonicalSlug":"402utils-holiday-api-36a1e4b2"}