{"uid":"cap_ucOYFNcjbAb4hGAtxtbQf","slug":"eu-verify-world-holidays-2dd9764e","name":"eu-verify World Holidays","description":"Full list of official public holidays for one country and year, from the Nager.Date registry (100+ countries, legally accurate dates). Query: ?country=FR (ISO 3166-1 alpha-2, required) &year=2026 (1975-2077, defaults to current year). Returns date, English + local name, nationwide flag, regional counties and holiday types per entry. Cached 24h.","url":"https://data.greeneris.io/v1/world/holidays","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":"integer","description":"Year between 1975 and 2077 (default: current year)"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code, e.g. FR"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":2026,"count":11,"source":"Nager.Date public holidays API (date.nager.at, open-source MIT project)","country":"FR","holidays":[{"date":"2026-01-01","name":"New Year's Day","types":["Public"],"counties":null,"local_name":"Jour de l'an","nationwide":true}]}},"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_Dz4wMhA0Sz41EcxTfMgYH","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 the list of public holidays for a given country and year using the Nager.Date open-source registry","exampleAgentPrompt":"Can you give me the full list of public holidays in France for 2026, so I know which days to exclude from our scheduling?","exampleUseCases":null,"resultDescription":"A JSON object containing the country code, year, total holiday count, data source attribution, and an array of holiday objects each with date, English name, local language name, type labels (e.g. Public), nationwide boolean, and optional county-level scope.","failureModes":["Missing required 'country' query parameter returns an error","Invalid or unsupported country code returns empty or error response","Year outside supported range 1975-2077 returns an error","HTTP 402 returned if payment has not been made via x402 protocol before retry","Network timeout or upstream Nager.Date API unavailability"],"whenToPreferThis":"Use this endpoint when you need an authoritative, structured list of public holidays for a specific country and year — especially for European countries — to support scheduling, payroll processing, SLA calculations, or compliance checks. Prefer this over scraping government websites or using approximate internal knowledge, as it sources from the well-maintained Nager.Date open-source registry. It is available pay-per-call with no API key required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:55:58.429Z","isFirstParty":false}