{"uid":"cap_lYYwGKE7T-PX9lLV6BMOa","slug":"public-holidays-and-workdays-nager-date-fa2fc9cf","name":"Public Holidays and Workdays (Nager.Date)","description":"Public holidays and business-day check for Norway and 200+ other countries, from the open-source Nager.Date holiday database. Without dato: every public and bank holiday of a year with local and English name and whether it is nationwide or regional. With dato: whether that date is a holiday or weekend, plus the next business day. Use it for deadline and SLA maths, delivery and payroll scheduling, or opening-hours logic. Compact JSON.","url":"https://nordata.hihat.workers.dev/helligdager?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["land","aar"],"properties":{"aar":{"type":"string","description":"Year as YYYY (optional, default current year; ignored when dato is given). Upstream covers roughly 1976-2074."},"dato":{"type":"string","description":"Date as YYYY-MM-DD (optional). Instead of the year list you get whether that date is a public holiday or weekend (Sat/Sun) and neste_virkedag = the first Mon-Fri non-holiday date strictly after it."},"land":{"type":"string","description":"ISO 3166-1 alpha-2 country code (NO, SE, DK, DE, GB, US, ... 200+ countries). Default NO."},"region":{"type":"string","description":"ISO 3166-2 subdivision code such as DE-BY or GB-SCT (optional). Regional holidays count as days off only for the given region; without it only nationwide holidays stop a business day."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"const":"json"},"example":{"type":"object","properties":{"aar":{"type":"number"},"land":{"type":"string"},"kilde":{"type":"string"},"antall":{"type":"number"},"format":{"type":"string"},"hentet":{"type":"string"},"helligdager":{"type":"array","items":{"type":"array","items":{}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CO5pN2EpqGKyHeM8a9mry","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns public holidays for a given country and year, or checks whether a specific date is a holiday/weekend and returns the next business day.","exampleAgentPrompt":"Can you check if March 17, 2025 is a public holiday or weekend in Ireland (IE), and if so, what the next business day would be?","exampleUseCases":[{"title":"Payroll deadline scheduling for Norway","prompt":"I need to know all public holidays in Norway for 2025 so I can figure out which payroll dates to shift — can you pull the full list including whether each one is nationwide or regional?"},{"title":"SLA next-business-day calculation","prompt":"Our SLA requires a response within one business day. A ticket came in on December 24, 2025 in Germany (DE) — what is the next working day we need to respond by?"},{"title":"E-commerce delivery date check for the US","prompt":"We're scheduling deliveries and need to know if November 27, 2025 is a public holiday in the US so we can skip it — and if it is, tell me the next available business day."}],"resultDescription":"For year-mode requests: a JSON object with the year, country code, source attribution, and an array of holiday entries each containing the date, local name, English name, and a flag indicating if it is nationwide or regional. For date-mode requests: a JSON object indicating whether the given date is a public holiday or weekend, plus the next business day (neste_virkedag) as a date string.","failureModes":["Unsupported country code returns an error or empty holiday list","Invalid date format (not YYYY-MM-DD) causes a bad request response","Year out of supported range (roughly 1976-2074) may return empty or error","Regional subdivision code not recognized for the given country returns only nationwide holidays or an error","Missing required 'land' parameter defaults to NO (Norway) which may be unintended"],"whenToPreferThis":"Choose this endpoint when you need authoritative public holiday data for 200+ countries with both local-language and English holiday names, regional subdivision support, and built-in next-business-day calculation. It is especially well-suited for deadline/SLA math, payroll scheduling, and delivery date logic where you need to skip both weekends and public holidays in a single API call. Prefer it over generic calendar APIs when you need compact JSON output and per-call micropayment pricing without a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:32:49.349Z","isFirstParty":false,"canonicalSlug":"public-holidays-and-workdays-nager-date-fa2fc9cf"}