{"uid":"cap_DvaxMh8DCV3NkYwpkujeM","slug":"public-holidays-api-42dd9fea","name":"Public Holidays API","description":"Public holidays of 150+ countries and their states/regions, or stock-market holidays (NYSE, ECB TARGET), for any year, and whether a given date is a holiday or business day with the next business day. Use for scheduling, delivery dates, payroll or market-open checks.","url":"https://bess-x402.onrender.com/v1/util/holidays?utm_source=zero.xyz","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"date":{"type":"string","description":"Date to check, YYYY-MM-DD"},"year":{"type":"integer","description":"Year, default current"},"country":{"type":"string","description":"ISO 3166 alpha-2 code (US, DE, AE) or market NYSE / ECB"},"subdivision":{"type":"string","description":"State or region code, e.g. CA, BY"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_agimd6VSWVuqdzNwyfdde","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","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 150+ countries and their subdivisions, or stock-market holidays (NYSE, ECB TARGET), for any year; also checks whether a specific date is a holiday or business day and returns the next business day.","exampleAgentPrompt":"Is December 26, 2025 a public holiday or business day in the UK, and if it is a holiday, what is the next business day?","exampleUseCases":[{"title":"Payroll next business day check","prompt":"Our payroll runs on the 25th of each month — is December 25, 2025 a business day in the US, and if not, what is the next business day we should use?"},{"title":"NYSE market holiday scheduling","prompt":"Can you list all NYSE stock market holidays for 2025 so I know which days trading won't be possible?"},{"title":"Multi-region delivery cutoff planning","prompt":"I need to know all public holidays in Bavaria, Germany (subdivision BY) for 2025 so we can plan delivery cutoff dates for our customers there."}],"resultDescription":"Returns a list of holidays for the requested country and year (with holiday names and dates), and if a specific date is provided, indicates whether it is a holiday or business day and provides the next business day. For markets like NYSE or ECB, returns the equivalent trading/settlement holidays.","failureModes":["Invalid or unsupported country code returns an error or empty result","Unsupported subdivision code may return no subdivision-specific holidays","Year out of supported range may return empty or error","Missing required 'country' parameter results in a validation error","Market identifiers other than NYSE/ECB may not be recognized"],"whenToPreferThis":"Choose this endpoint when you need authoritative public holiday data for a wide range of countries (150+) and their states/regions, or need to determine whether a specific date is a business day and find the next business day. Particularly well-suited for payroll scheduling, delivery date calculation, market-open checks, and any workflow that must respect local public holidays. Prefer this over generic calendar APIs when you need subdivision-level holiday granularity or stock-market-specific holiday calendars.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:09:37.119Z","isFirstParty":false,"canonicalSlug":"public-holidays-api-42dd9fea"}