{"uid":"cap_lEpYbw20vRQWjh2LDb7sK","slug":"euroref-public-holidays-by-country-f7541b61","name":"Euroref Public Holidays by Country","description":"European government reference data for 35 countries as cited JSON: central-bank policy rates, VAT/GST and VAT registration thresholds, CPI, corporate, personal and withholding tax, social contributions, minimum wages, statutory interest, official FX rates, filing deadlines and public holidays (coverage varies by country). Every value carries its official source URL and last-confirmed date. Single facts $0.003; country brief (every series for one country) $0.01; cross-country compare (one series, up to 10 countries) $0.02; tax-ID and VAT-number checks $0.003; computed answers (VAT, income tax, working days, minimum-wage check) $0.01-$0.02. Pay per call in USDC on Base via x402 or MPP, no signup, or by card with credit packs or monthly plans on one key valid across all 7 regional services. Free tier: GET /catalog, plus a free email key with 50 answer calls a day, commercial use allowed. Finished answers, one cited dossier per call (supported countries vary per job; others are refused free): cost this hire (wage-floor verdict, contributions, employer cost) $0.50; charge this sale (which VAT applies, net/VAT/gross) $0.50; charge this sale certified (plus a signed VAT-rate extract) $0.75; invoice due date and statutory late interest $0.40; country evidence pack (brief plus signed extracts) $0.25; hire compare $0.75 for 2 countries, $1.00 for 3-5; next filings (VAT, PAYE, corporate-tax due dates rolled for holidays) $0.35.\n\nFree trial: 3 computed-answer calls per day per IP on POST /v1/answers/* with header X-Free-Trial: 1 (without it, the normal x402 402; once used up, the 402 carries free_trial_resets_at). MCP answer tools use the trial automatically when no api_key is passed. Every series of the evaluation country is free. Card credit (same per-call price as x402): /pricing.","url":"https://euroref.dev/v1/holidays/%7Bcountry%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":null,"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":null,"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_K-L4L756ubROfzuIsF7H0","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 official public holidays for a specified European country, cited to the official gazette or government source, with date, name, and sourcing metadata.","exampleAgentPrompt":"What are the official public holidays in Germany this year, with their gazette sources and dates?","exampleUseCases":[{"title":"Payroll compliance calendar setup","prompt":"Pull the official public holidays for France so I can flag which days to exclude from our payroll processing schedule — I need the gazette-cited dates."},{"title":"Cross-border project scheduling","prompt":"I'm planning a project timeline involving teams in Poland and the Netherlands — can you get me the official government holidays for both countries so I can avoid scheduling meetings on those days?"},{"title":"HR policy verification","prompt":"We need to verify which days are legally recognized public holidays in Sweden according to official government sources — can you fetch that for me with the source citations?"}],"resultDescription":"A JSON array of public holidays for the requested European country, each entry containing the holiday date, name, official source URL (gazette or government site), and last-confirmed date. Coverage and number of entries vary by country.","failureModes":["Country not in the 35-country coverage set — endpoint refuses with an error indicating unsupported country","Malformed or unrecognized country identifier returns a 400 or 422 error","Payment failure via x402/MPP results in a 402 Payment Required response","Stale data warning included when last-confirmed date is old","Rate limit exceeded on free tier (50 calls/day)"],"whenToPreferThis":"Choose this endpoint when you need authoritative, gazette-cited public holiday data for European countries with traceable official sources, rather than crowd-sourced or unverified holiday lists. Ideal for compliance, payroll, HR, and scheduling applications where source provenance matters. Prefer over generic calendar APIs when you need official confirmation dates and source URLs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T18:37:18.150Z","isFirstParty":false,"canonicalSlug":"euroref-public-holidays-by-country-590c69ba"}