{"uid":"cap_Gz6YG59yy9HR43cj2TEIs","slug":"public-holidays-by-country-and-year-4f82701c","name":"Public Holidays by Country and Year","description":"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.","url":"https://x402-catalog-history.ai-business-surface.workers.dev/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"year":{"type":"string"},"country":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_A7ODfiBNOZCval-SkgemF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"What are all the public holidays in Japan for 2026? I need the dates, local names, and which day of the week they fall on.","exampleUseCases":[{"title":"International payroll scheduling","prompt":"List all public holidays in Germany for 2025 so I can flag which days our payroll shouldn't process."},{"title":"Travel itinerary planning","prompt":"What are the public holidays in Japan for 2026? I want to know the dates and weekdays so I can plan around them."},{"title":"Cross-border meeting scheduling","prompt":"Can you pull the official public holidays for Brazil in 2025? I need to know which dates to avoid when scheduling meetings with our São Paulo team."}],"resultDescription":"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.","failureModes":["Invalid or unsupported country code returns an error or empty holiday list","Year out of range may return empty results or an error from the upstream Nager.Date API","Missing required country parameter returns a 400-level error","Upstream Nager.Date API unavailability causes fetch failure","Payment not completed (no PAYMENT-SIGNATURE header) returns 402 with pricing terms instead of data"],"whenToPreferThis":"Choose this endpoint when you need a simple, no-auth, single-GET lookup of public holidays for any country and year, with live data sourced from Nager.Date including local-language names and days-from-today offsets. Prefer it over maintaining a static holiday database or integrating directly with Nager.Date when you want a pay-per-call model with no API key setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:30:13.139Z","isFirstParty":false,"canonicalSlug":"public-holidays-by-country-and-year-4f82701c"}