{"uid":"cap_h9K5SQSZbuTLrP8jDovhv","slug":"fastx402-public-holidays-lookup-ae6a5f8f","name":"FastX402 Public Holidays Lookup","description":"200 pay-per-call tools for AI agents, from $0.001 per request in USDC on Base or Solana with x402. No account, no API key.","url":"https://fastx402.tools/public-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"],"type":"string"},"queryParams":{"type":"object","required":["country","year"],"properties":{"year":{"type":"string","description":"Year, 1975-2075"},"country":{"type":"string","description":"2-letter country code, e.g. DE, US, TR, GB"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"year":{"type":"integer"},"count":{"type":"integer"},"country":{"type":"string"},"holidays":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"name":{"type":"string"},"types":{"type":"array","items":{"type":"string"}},"counties":{"type":"null"},"local_name":{"type":"string"},"nationwide":{"type":"boolean"}}}},"nationwide_count":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"year":2026,"count":19,"country":"DE","holidays":[{"date":"2026-01-01","name":"New Year's Day","types":["Public"],"counties":null,"local_name":"Neujahr","nationwide":true},{"date":"2026-01-06","name":"Epiphany","types":["Public"],"counties":["DE-BW","DE-BY","DE-ST"],"local_name":"Heilige Drei Könige","nationwide":false},{"date":"2026-03-08","name":"International Women's Day","types":["Public"],"counties":["DE-BE","DE-MV"],"local_name":"Internationaler Frauentag","nationwide":false},{"date":"2026-04-03","name":"Good Friday","types":["Public"],"counties":null,"local_name":"Karfreitag","nationwide":true},{"date":"2026-04-05","name":"Easter Sunday","types":["Public"],"counties":["DE-BB"],"local_name":"Ostersonntag","nationwide":false},{"date":"2026-04-06","name":"Easter Monday","types":["Public"],"counties":null,"local_name":"Ostermontag","nationwide":true},{"date":"2026-05-01","name":"Labour Day","types":["Public"],"counties":null,"local_name":"Tag der Arbeit","nationwide":true},{"date":"2026-05-14","name":"Ascension Day","types":["Public"],"counties":null,"local_name":"Christi Himmelfahrt","nationwide":true},{"date":"2026-05-24","name":"Pentecost","types":["Public"],"counties":["DE-BB"],"local_name":"Pfingstsonntag","nationwide":false},{"date":"2026-05-25","name":"Whit Monday","types":["Public"],"counties":null,"local_name":"Pfingstmontag","nationwide":true},{"date":"2026-06-04","name":"Corpus Christi","types":["Public"],"counties":["DE-BW","DE-BY","DE-HE","DE-NW","DE-RP","DE-SL"],"local_name":"Fronleichnam","nationwide":false},{"date":"2026-08-15","name":"Assumption Day","types":["Public"],"counties":["DE-SL"],"local_name":"Mariä Himmelfahrt","nationwide":false},{"date":"2026-09-20","name":"World Children's Day","types":["Public"],"counties":["DE-TH"],"local_name":"Weltkindertag","nationwide":false},{"date":"2026-10-03","name":"German Unity Day","types":["Public"],"counties":null,"local_name":"Tag der Deutschen Einheit","nationwide":true},{"date":"2026-10-31","name":"Reformation Day","types":["Public"],"counties":["DE-BB","DE-MV","DE-SN","DE-ST","DE-TH","DE-HB","DE-HH","DE-NI","DE-SH"],"local_name":"Reformationstag","nationwide":false},{"date":"2026-11-01","name":"All Saints' Day","types":["Public"],"counties":["DE-BW","DE-BY","DE-NW","DE-RP","DE-SL"],"local_name":"Allerheiligen","nationwide":false},{"date":"2026-11-18","name":"Repentance and Prayer Day","types":["Public"],"counties":["DE-SN"],"local_name":"Buß- und Bettag","nationwide":false},{"date":"2026-12-25","name":"Christmas Day","types":["Public"],"counties":null,"local_name":"Erster Weihnachtstag","nationwide":true},{"date":"2026-12-26","name":"St. Stephen's Day","types":["Public"],"counties":null,"local_name":"Zweiter Weihnachtstag","nationwide":true}],"nationwide_count":9}},"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_GQ7gpiZ1QvXxqXnfJWzLA","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 a list of public holidays for a given country and year, including holiday names, dates, types, and regional applicability.","exampleAgentPrompt":"What are all the public holidays in Germany for 2026, including which ones are nationwide versus regional?","exampleUseCases":[{"title":"Scheduling around German bank holidays","prompt":"I need to schedule a delivery campaign in Germany for Q1 and Q2 2026 — can you pull up all the public holidays there so I know which days to avoid?"},{"title":"Checking US holidays for trip planning","prompt":"Pull up the full list of US public holidays for 2025 so I can see which federal holidays fall on a Monday and might be good long weekend travel days."},{"title":"Comparing regional holidays across Turkey","prompt":"What public holidays are observed in Turkey in 2025? I want to see the holiday names in both English and Turkish if available."}],"resultDescription":"A JSON object containing the country code, year, total holiday count, nationwide holiday count, and an array of holiday objects each with a date (YYYY-MM-DD), English name, local language name, type(s) (e.g. 'Public'), a list of applicable county/region codes (or null if nationwide), and a boolean indicating if the holiday is nationwide.","failureModes":["Invalid or unsupported country code returns an error or empty result","Year outside supported range 1975-2075 returns a validation error","Missing required query parameters (country or year) returns a 400-level error","Network or payment failure (x402 payment not processed) returns a 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need accurate, structured public holiday data for a specific country and year, especially when you need regional vs. nationwide breakdowns and local-language holiday names. Ideal for scheduling, date validation, calendar enrichment, and business logic that must account for local holidays. Useful when you want to avoid requiring an account or API key and prefer pay-per-call pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:53:32.221Z","isFirstParty":false,"canonicalSlug":"fastx402-public-holidays-lookup-ae6a5f8f"}