{"uid":"cap_DG93fAKRoLeiltSWDWaFe","slug":"toolsmith-holidays-business-day-api-6d473401","name":"Toolsmith Holidays & Business Day API","description":"Public holidays for any country and year, plus optional business-day checking. Pass country= (ISO alpha-2) and year=; add date= to learn whether that day is a business day, whether it is a weekend or public holiday, the holiday name, and the next business day. Covers 100+ countries. JSON response. $0.01 USDC per call, pay via x402, no API key.","url":"https://toolsmith-api.dassad10.workers.dev/t/time/holidays","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","description":"YYYY-MM-DD to run a business-day check, optional"},"year":{"type":"integer","description":"Year, default current"},"country":{"type":"string","description":"ISO 3166 alpha-2 country code, e.g. US, GB, DE"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":2026,"country":"US","holidays":[{"date":"2026-01-01","name":"New Year's Day","global":true}],"dateCheck":{"date":"2026-07-04","isBusinessDay":false,"isPublicHoliday":true,"nextBusinessDay":"2026-07-06"},"holidayCount":11}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IwYz8LN4L9kCVA5MNL-dJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns public holidays for any country and year, and optionally checks whether a specific date is a business day, weekend, or holiday.","exampleAgentPrompt":"Can you tell me all the public holidays in Germany for 2025, and also check whether December 26, 2025 is a business day?","exampleUseCases":[{"title":"Schedule meetings across global offices","prompt":"I need to find a good time to schedule an all-hands meeting with teams in the UK, Japan, and Brazil. Can you check which days in March 2025 are business days in all three countries so we can avoid holidays?"},{"title":"Payroll processing for multi-country staff","prompt":"We're processing payroll for February 2025 and have employees in Germany, France, and Australia. Can you list all the public holidays for each country so we know which days to account for in our calculations?"},{"title":"Contract deadline compliance verification","prompt":"Our contract with a vendor in Canada requires final deliverables by January 30th, 2025. Can you confirm that's a business day in Canada, and if not, what the next business day would be?"}],"resultDescription":"A JSON object listing all public holidays for the requested country and year, each with date and holiday name. If a date query parameter is provided, the response also includes whether that date is a business day, whether it falls on a weekend or public holiday, the name of the holiday (if any), and the next business day.","failureModes":["Missing required country parameter returns an error","Invalid ISO country code returns an error or empty holidays list","Unsupported country (not among 100+ covered) may return empty or error","Invalid date format (not YYYY-MM-DD) for optional date parameter causes error","Invalid year value may return error"],"whenToPreferThis":"Use this endpoint when you need authoritative public holiday data for any of 100+ countries, especially when combined with business-day validation logic. Prefer this over calendar libraries when you need a live, maintained, multi-country dataset without managing holiday data yourself. Ideal for scheduling, payroll, contract deadline, and compliance use cases.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:30:47.122Z","isFirstParty":false}