Is it a business day?
is_business_dayRead-onlyIdempotent
FREE, unmetered. Is this date a business day in this country? Returns is_business_day, the reason (weekend, public_holiday, makeup_workday…), the holiday names, and the next and previous business day. 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
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Date to classify, 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
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | 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 | ||
| reason | No | ||
| caveats | No | ||
| country | No | ||
| reached | No | On a refusal: the first date the calculation could not classify | |
| weekday | No | ||
| 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 | |
| no_charge | No | ||
| price_usd | No | ||
| disclaimer | No | ||
| how_to_pay | No | ||
| years_held | No | On year_not_held: the years whose holidays we do hold | |
| bind_series | No | ||
| explanation | No | ||
| x_next_bind | No | ||
| country_name | No | ||
| http_endpoint | No | ||
| is_weekend_day | No | ||
| is_business_day | No | ||
| public_holidays | No | ||
| what_you_can_do | No | ||
| payment_required | No | true when the call needs payment; how_to_pay explains x402 or card | |
| next_business_day | No | {date, weekday}, or date null with why_unknown when it falls outside the held calendar | |
| previous_business_day | No |