{"uid":"cap_-FYLt5y5FjVYHXxs5JHta","slug":"forgemesh-public-holidays-api-a4d9f6f0","name":"ForgeMesh Public Holidays API","description":"Public holidays API: the official public holidays for any country (110+ supported) and year — date, local name, English name, nationwide flag, and observing subdivisions as JSON. The data scheduling, payroll, SLA, and delivery agents check before promising a date. Cached 24 hours.","url":"https://x402.forgemesh.io/public-holidays","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_eqk0d-wktWqW5TttHNMEQ","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 (date, local name, English name, and type) for any of 200+ countries and any year as JSON","exampleAgentPrompt":"Can you pull the official public holidays for Germany in 2026 — I need the dates, local names, and whether each one is a public, bank, or school holiday?","exampleUseCases":null,"resultDescription":"A JSON array of holiday objects for the specified country and year, each containing the date, local name, English name, and holiday type (public, bank, school, or observance). Data is served from a locally bundled dataset with no third-party dependency at request time, covering 200+ countries.","failureModes":["Invalid or unsupported 2-letter country code — returns error or empty result","Year out of supported range — returns error or empty result","Malformed request body — returns validation error","Temporary service unavailability — returns HTTP 5xx","Payment failure or insufficient USDC balance — returns HTTP 402"],"whenToPreferThis":"Prefer this endpoint when you need authoritative, structured national holiday data for any of 200+ countries across any year without relying on a third-party upstream service. Ideal for scheduling agents, payroll systems, SLA checkers, and delivery planners that need to verify whether a date is a working day. Useful when low-latency, self-contained holiday lookups are required at $0.003 per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:01:59.221Z","isFirstParty":false}