Is this a business day? API

Tests whether an ISO date is a working day given a custom weekend mask and explicit holiday list, returning the weekday and the precise reason it is or isn't a business day. Answers 'Is 2026-07-04 a business day?', 'Is this date a weekend or a holiday?'.

Price$0.02per request

MethodPOST

Route/v1/datetime/is-business-day

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

datetimebusiness-dayworking-dayweekendholidaycalendaris-business-daybizday

API URLhttps://x402.hexl.dev/v1/datetime/is-business-day

Integration docs

Example request

{
  "date": "2026-07-04",
  "holidays": [
    "2026-07-03"
  ]
}

Example response

{
  "date": "2026-07-04",
  "weekday": "Saturday",
  "weekdayNumber": 6,
  "isBusinessDay": false,
  "isWeekend": true,
  "isHoliday": false,
  "reason": "weekend",
  "interpretation": "2026-07-04 (Saturday) is not a business day — weekend."
}

Input schema

{
  "type": "object",
  "required": [
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "examples": [
        "2026-07-04"
      ]
    },
    "weekendDays": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "examples": [
        [
          5,
          6
        ]
      ]
    },
    "holidays": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "examples": [
        [
          "2026-07-03"
        ]
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}