{"uid":"cap_yrYymx25OXeUfDE7rIKG4","slug":"freetier-agent-api-public-holidays-lookup-e6f8828f","name":"FreeTier Agent API — Public Holidays Lookup","description":"Pay-per-call data API for AI agents: AI model prices and cost calculator, 4,259 MCP servers, email domain checks, text-to-JSON extraction, country/holiday/currency lookup, page and link checks, page-to-markdown, 2,230 verified APIs. x402, USDC on Base, no signup. Sources cited in every response.","url":"https://freetier-agent-api.pages.dev/api/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"],"properties":{"date":{"type":"string"},"year":{"enum":["2026","2027"],"type":"string"},"country":{"type":"string","description":"ISO2"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":2026,"country":"DK","holidays":[{"date":"2026-01-01","name":"Nytårsdag"}]}},"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.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_onS4cQIwPjn0M_dbr8tHL","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 the list of public holidays for a given country and year (2026 or 2027) by ISO2 country code.","exampleAgentPrompt":"What are all the public holidays in Denmark for 2026? I need the dates and names.","exampleUseCases":[{"title":"Travel itinerary holiday avoidance","prompt":"Can you pull up all the public holidays in France for 2026 so I can plan my business trip around them and avoid scheduling meetings on those days?"},{"title":"HR payroll calendar planning","prompt":"I need a list of all official public holidays in Germany for 2027 so I can set up our payroll and leave calendar correctly for next year."},{"title":"Event scheduling conflict check","prompt":"Can you look up public holidays in Japan for 2026? I want to make sure the conference dates we're considering don't land on a national holiday."}],"resultDescription":"Returns a JSON object containing the country ISO2 code, year, and an array of holiday objects — each with a date (YYYY-MM-DD) and the holiday name in the local language.","failureModes":["Missing or invalid 'country' query parameter returns an error — must be a valid ISO2 country code","Requesting a year outside the supported enum (2026 or 2027) returns a validation error","Country codes not covered by the dataset may return an empty holidays array or a not-found error","Payment failure via x402/USDC results in a 402 response and no data returned"],"whenToPreferThis":"Choose this endpoint when you need a quick, pay-per-call holiday lookup without signup, especially in agent workflows that require minimal friction. It's well-suited for agents that already operate on x402/USDC on Base and need to enrich scheduling, payroll, or travel data with official public holiday information for 2026 or 2027. It's less suitable if you need historical holiday data (pre-2026) or real-time holiday updates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:52:24.163Z","isFirstParty":false,"canonicalSlug":"freetier-agent-api-public-holidays-lookup-e6f8828f"}