{"uid":"cap_dl-xtQphjX1SVWwVS1R-I","slug":"business-days-holidays-7e70c743","name":"Business Days & Holidays","description":"Use when an agent needs public holidays and a business-day count for a date range in any of 200+ countries (and subdivisions), e.g. for deadlines, delivery dates, travel or scheduling: holiday names, weekend rule, business days and next business day. $0.01 USDC on Base; charged only on 2xx, never for invalid input.","url":"https://api.facts402.com/business-days?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"end":{"type":"string","format":"date","description":"Last day, inclusive; max 366-day range"},"start":{"type":"string","format":"date","description":"First day, inclusive (YYYY-MM-DD)"},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"ISO 3166-1 alpha-2, e.g. DE"},"subdivision":{"type":"string","description":"Optional ISO 3166-2 subdivision, e.g. US state CA"}}},"responseSchema":null,"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_04pTIXDIbr14BIBHewfbL","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, weekend rules, and business-day count for any country (and optional subdivision) over a specified date range, including the next business day.","exampleAgentPrompt":"How many business days are there between March 3, 2025 and April 30, 2025 in Germany (DE), and what public holidays fall in that range?","exampleUseCases":[{"title":"Deadline calculation for legal contract","prompt":"I need to know how many business days there are between April 1, 2025 and April 30, 2025 in France — we have a contract deadline and need to account for any public holidays."},{"title":"E-commerce delivery estimate for Japan","prompt":"Can you figure out the next business day after May 3, 2025 in Japan (JP)? We're shipping an order and need to skip Golden Week holidays."},{"title":"Payroll schedule for US state California","prompt":"List all public holidays and the total number of business days in Q3 2025 for California (US, subdivision CA) so I can plan our payroll calendar."}],"resultDescription":"Returns a JSON object containing the list of public holidays (with names and dates), the weekend rule for the country (e.g. Saturday/Sunday), the total count of business days in the range, and the next business day after the end date.","failureModes":["Invalid or unsupported country code returns an error","Date range exceeding 366 days is rejected","Malformed date format causes a 400 Bad Request","Unsupported subdivision code may return a generic country-level result or error","Network timeout for very large date ranges or high-load periods"],"whenToPreferThis":"Use this endpoint when you need authoritative public holiday data and business-day counts for 200+ countries and their subdivisions, especially for scheduling, deadline calculation, delivery estimation, or travel planning. Prefer it over generic calendar libraries that may have outdated or incomplete holiday data, particularly for non-Western countries with complex weekend rules (e.g. Middle Eastern countries with Friday/Saturday weekends).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:33.814Z","isFirstParty":false,"canonicalSlug":"business-days-holidays-7e70c743"}