{"uid":"cap_6BQdQCIqrsMWuUjc6URZ7","slug":"public-holiday-business-day-api-100-countries-e0de60be","name":"Public Holiday & Business Day API (100+ Countries)","description":"Public and bank holidays for 100+ countries, and the business-day answer behind them. Returns holidays[] with localName, name, global and types; pass ?date= and it also answers isBusinessDay with nextBusinessDay and previousBusinessDay, walking weekends and year boundaries. Requires ?country=<ISO 3166-1 alpha-2, e.g. US>; optional ?date=YYYY-MM-DD or ?year=1975..2100. Errors: 400 bad_country (a 3-letter code like USA is rejected)|bad_date|bad_year, 404 unknown_country.","url":"https://x402.donnyautomation.com/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. Adds the isBusinessDay answer plus next and previous business days."},"year":{"type":"string","description":"Calendar year 1975..2100 (default: current year). Ignored when date is given."},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code, e.g. US, GB, DE, JP."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ts":"2026-08-03T00:00:00.000Z","year":2026,"count":1,"country":"US","holidays":[{"date":"2026-07-03","name":"Independence Day","types":["Public"],"global":true,"localName":"Independence Day"}],"attribution":"Holiday data from Nager.Date (public domain).","businessDay":{"date":"2026-07-04","reason":"weekend","weekday":"Saturday","isBusinessDay":false,"nextBusinessDay":"2026-07-06","previousBusinessDay":"2026-07-02"}}},"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_2Tatf9MSY96HD8TbN0Z1f","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 and bank holidays for a given country and year, and answers whether a specific date is a business day with next/previous business day navigation.","exampleAgentPrompt":"Is March 17 2025 a business day in Ireland, and if not, what are the nearest business days on either side?","exampleUseCases":[{"title":"Settlement date calculation for finance","prompt":"We have a trade settling in 3 business days from November 27 2025 in the US — can you work out the exact settlement date, skipping weekends and any US public holidays?"},{"title":"Payroll scheduling across year boundary","prompt":"Our payroll is due on December 31 2025 in the UK — is that a business day, and if not, what's the previous business day we should use instead?"},{"title":"SLA deadline verification for logistics","prompt":"I need to confirm whether August 15 2025 counts as a working day in France for our delivery SLA — and if it's a holiday, what's the next business day?"}],"resultDescription":"A list of holidays for the country and year with each holiday's local name, English name, date, whether it is nationwide, and which regions observe it. When a date is supplied, also returns a boolean isBusinessDay flag plus the dates of the next and previous business days (crossing weekends and holidays, including across year boundaries).","failureModes":["Missing or invalid country code returns an error — must be ISO 3166-1 alpha-2","Year outside supported range 1975–2100 may return an error or empty result","Invalid date format (not YYYY-MM-DD) returns a parsing error","Network or payment (x402) failure prevents the response","Some countries may have incomplete or unofficial regional holiday data"],"whenToPreferThis":"Choose this endpoint when you need authoritative public and bank holiday data for 100+ countries with direct business-day computation built in — avoiding the need to implement your own weekend/holiday walking logic. It is especially useful for settlement, payroll, SLA, and scheduling agents that need to cross year boundaries or handle regional holiday distinctions in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:49:00.224Z","isFirstParty":false}