{"uid":"cap_6TzzaZo3uvDzIN-S4qZIf","slug":"forgemesh-holiday-calendar-lookup-22141d98","name":"ForgeMesh Holiday Calendar Lookup","description":"Query the official public holidays for a given country and year, returned with local and English names, nationwide-vs-regional scope, and observing subdivisions. For scheduling agents that need to check whether a date is a holiday before committing to a delivery window or SLA deadline. Cached for a full day.","url":"https://x402.forgemesh.io/holiday-calendar-lookup","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"year":{"type":"string","description":"default 2026"},"country":{"type":"string","description":"2-letter code, default US"}}},"responseSchema":{"type":"json","example":{"data":[{"date":"2026-07-03","name":"Independence Day","fixed":true,"types":["Public"],"global":true,"counties":null,"localName":"Independence Day","launchYear":null,"countryCode":"US"}]}},"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_dyvGTzO72QWwVTfkadHxF","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 official national public holidays for a given country and year, including local names, English names, and holiday types.","exampleAgentPrompt":"Before I confirm that March 5 2026 delivery SLA for our German customer, can you check whether it falls on a national public holiday in Germany for 2026?","exampleUseCases":null,"resultDescription":"A list of national public holidays for the requested country and year, each entry including the holiday date, local-language name, English name, and holiday type (e.g. national, regional, observance). Data is served from a local bundle with no third-party dependency.","failureModes":["Invalid or unsupported 2-letter country code returns an error or empty result","Year outside supported range may return empty or error response","Malformed request body causes a 400-level error","Payment failure (insufficient USDC balance) blocks the request via x402 protocol"],"whenToPreferThis":"Choose this endpoint when you need authoritative, structured national holiday data for scheduling, SLA validation, or delivery window checks — especially when you want local-language holiday names alongside English names and holiday type classification. Prefer this over web-scraping or general LLM knowledge because it serves bundled, consistent data with no third-party dependency at request time, making it reliable for automated agent workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:01:09.232Z","isFirstParty":false}