{"uid":"cap_bk8EXk2KktlL9MVD0TPED","slug":"toll402-public-holidays-lookup-d1f0033f","name":"Toll402 Public Holidays Lookup","description":"The OpenRouter for AI-agent tools: one gateway, one wallet, every capability. Built-in tools, forged tools, a global verified business directory and 2,000+ aggregated x402 services, all paid per call in USDC via x402 (HTTP 402). No signup, no API key.","url":"https://toll402.dev/v1/t/public_holidays","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["countryCode","year"],"properties":{"year":{"type":"integer","description":"Four-digit year, e.g. 2024"},"countryCode":{"type":"string","description":"ISO 3166-1 alpha-2 country code, e.g. US, BR, DE"}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true}},"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_5KZyyqsle-aOB5T5RxZrh","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 using ISO 3166-1 alpha-2 country codes","exampleAgentPrompt":"Can you give me a list of all public holidays in Germany for 2025?","exampleUseCases":[{"title":"Holiday-aware scheduling for international teams","prompt":"I need to schedule meetings with our teams in Brazil, Germany, and Japan throughout 2025 — can you pull up the public holidays for each of those countries so I can avoid booking on those days?"},{"title":"E-commerce shipping blackout dates","prompt":"We ship to the US and Canada — can you get me all the public holidays in both countries for 2025 so we can block out those dates in our shipping calendar?"},{"title":"HR leave planning calendar","prompt":"I'm building a leave policy for our France office — what are all the official public holidays in France for 2024?"}],"resultDescription":"A JSON response with ok:true and a list of public holidays for the requested country and year, including holiday names and their calendar dates.","failureModes":["Invalid or unsupported country code returns an error response","Year out of supported range may return an error or empty holiday list","Malformed request body (missing countryCode or year) returns a validation error","Payment failure via x402 results in HTTP 402 and no data returned"],"whenToPreferThis":"Use this endpoint when you need a programmatic, per-call lookup of official public holidays for a specific country and year, especially in agentic workflows that require scheduling, date validation, or calendar enrichment across multiple countries, without managing API keys or subscriptions. Ideal when paying per call in USDC via x402 is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:57:26.352Z","isFirstParty":false}