{"uid":"cap_7-JvqNGgb90w1Eyqk7Sad","slug":"holiday-calendar-api-business-day-count-5849e05e","name":"Holiday Calendar API – Business Day Count","description":"Business-day count excluding weekends and full-day Public or Bank holidays; Optional and HalfDay observances remain business days.","url":"https://holidays.use.x402atlas.com/business-days","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","from","to"],"properties":{"to":{"type":"string","format":"date","description":"Inclusive range end, at most 365 days after from"},"from":{"type":"string","format":"date","description":"Inclusive range start"},"country":{"enum":["AD","AL","AT","BE","BG","BR","BY","CH","CZ","DE","EE","ES","FR","HR","HU","IE","IT","LI","LT","LU","LV","MC","MD","MT","MX","NL","PL","PT","RO","RS","SE","SI","SK","SM","VA","ZA"],"type":"string","description":"Supported ISO 3166-1 alpha-2 country code: AD Andorra; AL Albania; AT Austria; BE Belgium; BG Bulgaria; BR Brazil; BY Belarus; CH Switzerland; CZ Czechia; DE Germany; EE Estonia; ES Spain; FR France; HR Croatia; HU Hungary; IE Ireland; IT Italy; LI Liechtenstein; LT Lithuania; LU Luxembourg; LV Latvia; MC Monaco; MD Moldova; MT Malta; MX Mexico; NL Netherlands; PL Poland; PT Portugal; RO Romania; RS Serbia; SE Sweden; SI Slovenia; SK Slovakia; SM San Marino; VA Vatican City; ZA South Africa."},"language":{"type":"string","pattern":"^[A-Z]{2}$","description":"Optional two-letter ISO 639-1 result language. Defaults to English when available."},"subdivision":{"type":"string","pattern":"^[A-Z]{2}-.+$","maxLength":20,"description":"Optional regional subdivision code beginning with the selected country code, for example DE-BE."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["country","from","to","total_days","business_days","weekend_days","holiday_weekdays","queried_at"],"properties":{"to":{"type":"string","format":"date"},"from":{"type":"string","format":"date"},"country":{"type":"string"},"queried_at":{"type":"string","format":"date-time"},"total_days":{"type":"integer"},"subdivision":{"type":"string"},"weekend_days":{"type":"integer"},"business_days":{"type":"integer"},"holiday_weekdays":{"type":"integer","description":"Weekdays closed by full-day Public or Bank holidays"}}}}}}},"responseSchema":{"type":"json","example":{"to":"2026-01-10","from":"2026-01-01","country":"DE","queried_at":"2026-07-27T12:00:00Z","total_days":10,"subdivision":"DE-BE","weekend_days":3,"business_days":6,"holiday_weekdays":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XsSPpkmOnTyCYXWgY96I8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Counts the number of business days between two dates for a given country, excluding weekends and full-day public or bank holidays.","exampleAgentPrompt":"How many business days are there between March 1 and March 31, 2025 in Germany (DE), excluding weekends and public holidays?","exampleUseCases":[{"title":"Payroll cycle business day count","prompt":"How many business days are in the French (FR) pay period from April 1 to April 30, 2025, excluding weekends and public holidays?"},{"title":"Contract delivery deadline calculation","prompt":"I need to know how many business days fall between May 12 and June 30, 2025 in the Netherlands (NL) so I can set SLA milestones for a client contract."},{"title":"Regional holiday-aware project planning","prompt":"Can you tell me how many working days there are from January 6 to March 31, 2025 in Bavaria (DE-BY), excluding weekends and all German public holidays?"}],"resultDescription":"Returns a JSON object with the queried country, date range (from/to), total calendar days, number of business days, weekend days, and holiday weekdays, along with the timestamp of the query. The business_days count excludes weekends and full-day Public or Bank holidays; Optional and HalfDay observances are counted as business days.","failureModes":["Unsupported country code returns a validation error — only the 36 listed ISO 3166-1 alpha-2 codes are accepted","Date range exceeding 365 days returns an error","Invalid date format (non-ISO 8601) causes a schema validation failure","Subdivision code not matching the selected country prefix causes rejection","Missing required parameters (country, from, to) returns a 400-level error","Payment failure or insufficient USDC balance returns a 402 Payment Required error"],"whenToPreferThis":"Choose this endpoint when you need an authoritative, precomputed count of business days between two dates for a specific country or regional subdivision, without having to maintain your own holiday database. It is ideal for payroll, SLA, contract, or billing calculations where accuracy against official public holiday calendars matters. Prefer this over generic date-math libraries that may lack up-to-date or country-specific holiday data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:44.661Z","isFirstParty":false}