GET /v1/is-business-day
GET /v1/is-business-day?country=&date= answers true or false for one date, and gives the reason when the answer is false.
Parameters
| Parameter | Notes |
|---|---|
country | ISO alpha-2. |
date | YYYY-MM-DD, inside 2026. |
Response fields
| Field | Meaning |
|---|---|
is_business_day | true when the date is a working day in that country. |
reason | weekend or holiday (with the name) when false, null when true. |
weekend_rule | The weekend applied, Sat-Sun or Fri-Sat. |
Three checks worth running
| Call | Result | Why |
|---|---|---|
country=US&date=2026-01-03 | false | Saturday in the US. |
country=SA&date=2026-01-02 | false | Friday is weekend in Saudi Arabia. |
country=SA&date=2026-01-04 | true | Sunday is a working day in Saudi Arabia. |
Use this endpoint at checkout or scheduling time, when one date is all you have. A whole range belongs on the business-days endpoint, which costs one call instead of thirty.
Examples you can run
curl:
curl -s "https://api.kingai.work/v1/is-business-day?country=SA&date=2026-01-02"Error codes
| HTTP | Code | Meaning |
|---|---|---|
| 400 | invalid_parameter | A parameter is missing or malformed, for example a date that is not YYYY-MM-DD. |
| 404 | country_not_found | The country code is not in the covered set of 12. |
| 404 | year_not_covered | Only 2026 is in the dataset. Other years return this error instead of a guess. |
Errors use one shape: {"error": {"code": "...", "message": "..."}}. Try the bad-country button in the console to see one.