{"uid":"cap_s2oXIkOoHUV_QFAxkRA4S","slug":"holiday-calendar-api-add-business-days-1c61357a","name":"Holiday Calendar API – Add Business Days","description":"Add business days while skipping weekends and full-day Public or Bank holidays; Optional and HalfDay observances are retained.","url":"https://holidays.use.x402atlas.com/add-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","date","days"],"properties":{"date":{"type":"string","format":"date","description":"Starting ISO date; counting begins on the following day"},"days":{"type":"integer","maximum":366,"minimum":1,"description":"Number of business days to add"},"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","start_date","business_days","result_date","queried_at"],"properties":{"country":{"type":"string"},"queried_at":{"type":"string","format":"date-time"},"start_date":{"type":"string","format":"date"},"result_date":{"type":"string","format":"date"},"subdivision":{"type":"string"},"business_days":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"country":"DE","queried_at":"2026-07-27T12:00:00Z","start_date":"2026-01-01","result_date":"2026-01-08","subdivision":"DE-BE","business_days":5}},"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__dWvuymwraPCYXYtk40S2","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":"Calculates a future date by adding a specified number of business days to a starting date, skipping weekends and full-day public/bank holidays for a given country or regional subdivision.","exampleAgentPrompt":"What date is 10 business days after 2025-03-01 in Germany (DE), skipping weekends and public holidays?","exampleUseCases":[{"title":"SLA deadline calculation for contracts","prompt":"We signed a contract in France on 2025-04-10 — what date is exactly 20 business days later, skipping French public holidays and weekends?"},{"title":"Payment settlement window planning","prompt":"Our payment processor settles in 5 business days — if we initiate on 2025-12-22 in Brazil (BR), what's the actual settlement date accounting for Brazilian bank holidays?"},{"title":"HR onboarding start date scheduling","prompt":"A new hire in the DE-BE subdivision of Germany starts their notice period on 2025-06-01 — what date is 30 business days from then, using Berlin regional holidays?"}],"resultDescription":"Returns a JSON object containing the computed result date (the date after adding the specified business days), the original start date, the country used, the number of business days added, and a timestamp of when the query was made. Full-day public and bank holidays are excluded; optional and half-day observances are retained in the count.","failureModes":["Invalid or unsupported country code returns an error — only the listed 35 countries are supported","Date format not in ISO 8601 (YYYY-MM-DD) format causes a validation failure","Days parameter outside the range 1–366 returns a schema validation error","Subdivision code that doesn't match the selected country prefix causes an error","Missing required parameters (country, date, days) returns a 400 bad request"],"whenToPreferThis":"Use this endpoint when you need to calculate a precise future date by adding a set number of business days while correctly accounting for country-specific public and bank holidays. Prefer this over generic date-math libraries when country-specific holiday calendars matter (e.g. SLA windows, payment settlement dates, HR notice periods, legal deadlines). It is especially useful for European and Latin American jurisdictions where regional subdivision holidays differ from national ones.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:36:17.727Z","isFirstParty":false}