{"uid":"cap_zivLxLqqxj8QCLVs2H-ik","slug":"fittings-holiday-check-6e3a28b9","name":"fittings Holiday Check","description":"Answer whether one date is a public holiday in one country, with its name, regional scope and the next holiday that year.","url":"https://fittings.sh/v1/time/holiday-check","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":["countryCode","date"],"properties":{"date":{"type":"string","description":"ISO date YYYY-MM-DD"},"countryCode":{"type":"string","description":"ISO 3166-1 alpha-2, e.g. US"}}}},"additionalProperties":false}}},"responseSchema":null,"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_9vi1X9XLtZ_C0WFMYHvJx","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":"Checks whether a given date is a public holiday in a specified country, returning the holiday name, regional scope, and the next upcoming holiday that year.","exampleAgentPrompt":"Is July 4th 2025 a public holiday in the US, and if so what's it called and when is the next one that year?","exampleUseCases":[{"title":"Avoiding holiday scheduling conflicts","prompt":"Before I send out meeting invites for November 11 to our team in France, can you check if that's a public holiday there and tell me when the next one after that would be?"},{"title":"Travel planning around national holidays","prompt":"I'm visiting Japan in early May 2025 — is May 3rd a public holiday there, and what's the name of it?"},{"title":"HR payroll calendar automation","prompt":"For our payroll system, can you check whether December 26 2025 is a public holiday in the UK and tell me its regional scope?"}],"resultDescription":"Returns whether the queried date is a public holiday in the given country, the official name of the holiday if it is, its regional scope (national or specific regions), and the date and name of the next public holiday occurring in the same calendar year.","failureModes":["Invalid or unsupported country code returns an error or empty result","Date not in YYYY-MM-DD format causes a validation error","Date outside the supported year range may return no data","Country with no holiday data in the dataset returns empty or error","Network timeout or service unavailability returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need a quick, single-date holiday check for a specific country with minimal setup — particularly useful for scheduling automation, HR tools, travel planning, or business-day calculations. Prefer this over building a local holiday database when you need authoritative, up-to-date data without maintaining country-specific logic yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:36:27.276Z","isFirstParty":false}