Add business days to a date
add_business_daysFREE, unmetered. The date n business days after (or, for negative n, before) a start date. The start date is day 0 and never counted; n = 0 returns the date itself if it is a business day, otherwise the next one. Lists every non-business day skipped and why. Uses the country's national public-holiday calendar and its statutory weekend rule (Gulf Friday+Saturday, Israel Saturday-only, India 2nd/4th Saturdays, Nepal's 2026 change, China's multi-day breaks and make-up working days). A date in a year whose holidays we do not hold is refused with error year_not_held and the years_held list; it is never computed from weekends alone. A statutory holiday whose date is not yet fixed is refused as holiday_date_pending. Regional (sub-national) holidays are not applied.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| n | Yes | Business days to add; negative walks backward | |
| date | Yes | Start date (day 0), YYYY-MM-DD | |
| country | Yes | ISO 3166-1 alpha-2 country code, e.g. 'za', 'ae', 'in'. Every country we hold a holiday calendar for is accepted on every brand, not only this brand's region. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| n | No | ||
| free | No | ||
| year | No | On year_not_held: the year we do not hold | |
| basis | No | ||
| error | No | Present on a free refusal or error; no charge | |
| price | No | ||
| caveats | No | ||
| country | No | ||
| reached | No | On a refusal: the first date the calculation could not classify | |
| weekend | No | Weekend days applied, the basis of that rule, and any dated or sub-national note | |
| calendar | No | Holiday calendar used: years_held, source, last_confirmed, stale | |
| direction | No | ||
| no_charge | No | ||
| price_usd | No | ||
| convention | No | ||
| disclaimer | No | ||
| how_to_pay | No | ||
| start_date | No | ||
| years_held | No | On year_not_held: the years whose holidays we do hold | |
| bind_series | No | ||
| explanation | No | ||
| result_date | No | ||
| x_next_bind | No | ||
| country_name | No | ||
| http_endpoint | No | ||
| result_weekday | No | ||
| what_you_can_do | No | ||
| payment_required | No | true when the call needs payment; how_to_pay explains x402 or card | |
| calendar_days_moved | No | ||
| non_business_days_skipped | No |