{"uid":"cap_3YjvttEQyThg9x12gVFQX","slug":"api-strale-io-ddb2a7ec","name":"Holiday Calendar API – Public Holidays by Country and Year","description":"Get public holidays by country and year for the 200+ countries covered by Nager.Date. Returns holiday names, dates, types (public/bank/optional), and whether they are fixed or variable.","url":"https://api.strale.io/x402/holiday-calendar?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["country_code"],"properties":{"year":{"type":"integer","description":"Year (default current year)"},"country_code":{"type":"string","description":"ISO 2-letter country code"}}},"responseSchema":{"year":{"type":"integer"},"holidays":{"type":"array"},"country_code":{"type":"string"},"total_holidays":{"type":"integer"}},"example":{"request":{"year":2025,"country_code":"FR"},"response":{"year":2025,"_meta":{"payment":{"method":"x402","price_usd":0.0216,"settlement_id":"0x7745cd160a7dd98333818b6f7531db8a789920534592d93b2efe92c3de5ad7ec"},"capability":"holiday-calendar","latency_ms":132,"provenance":{"source":"nager.date","fetched_at":"2026-06-16T01:23:59.265Z"}},"holidays":[{"date":"2025-01-01","name":"New Year's Day","type":"Public","fixed":false,"global":true,"counties":null,"local_name":"Jour de l'an"},{"date":"2025-04-21","name":"Easter Monday","type":"Public","fixed":false,"global":true,"counties":null,"local_name":"Lundi de Pâques"},{"date":"2025-05-01","name":"Labour Day","type":"Public","fixed":false,"global":true,"counties":null,"local_name":"Fête du Travail"},{"date":"2025-05-08","name":"Victory in Europe Day","type":"Public","fixed":false,"global":true,"counties":null,"local_name":"Victoire 1945"},{"date":"2025-05-29","name":"Ascension Day","type":"Public","fixed":false,"global":true,"counties":null,"local_name":"Ascension"},{"date":"2025-06-09","name":"Whit Monday","type":"Public","fixed":false,"global":true,"counties":null,"local_name":"Lundi de Pentecôte"},{"date":"2025-07-14","name":"Bastille Day","type":"Public","fixed":false,"global":true,"counties":null,"local_name":"Fête nationale"},{"date":"2025-08-15","name":"Assumption Day","type":"Public","fixed":false,"global":true,"counties":null,"local_name":"Assomption"},{"date":"2025-11-01","name":"All Saints' Day","type":"Public","fixed":false,"global":true,"counties":null,"local_name":"Toussaint"},{"date":"2025-11-11","name":"Armistice Day","type":"Public","fixed":false,"global":true,"counties":null,"local_name":"Armistice 1918"},{"date":"2025-12-25","name":"Christmas Day","type":"Public","fixed":false,"global":true,"counties":null,"local_name":"Noël"}],"country_code":"FR","total_holidays":11}},"exampleRequest":{"year":2025,"country_code":"FR"},"tags":["x402"],"displayCostAmount":"0.0216","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0216/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0216","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0216","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jF5qnto8WWQhR0NTHChGK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0216","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, including holiday names, dates, types, and fixed vs. variable status, covering 100+ countries.","exampleAgentPrompt":"Can you get me the full list of public holidays in France for 2025, including whether each one is fixed or variable and what type it is?","exampleUseCases":null,"resultDescription":"A list of holidays for the requested country and year, each entry containing the holiday name, date, type (public, bank, or optional), and whether the holiday falls on a fixed date or varies each year.","failureModes":["Missing or invalid country_code returns an error (must be valid ISO 2-letter code)","Unsupported country code returns empty or error response","Invalid year value may return an error or fallback to current year","Network or payment (x402) failure prevents response"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable public holiday data for scheduling, compliance, date calculations, or calendar enrichment for any of 100+ supported countries. Prefer this over general web search when you need typed metadata (public vs bank vs optional, fixed vs variable) rather than plain text.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:54:44.693Z","isFirstParty":false,"canonicalSlug":"api-strale-io-ddb2a7ec"}