Add N business days API

Adds (or subtracts, if negative) N working days to an ISO date, skipping a custom weekend mask and explicit holidays, returning the landing date, its weekday and how many non-business days were skipped. Answers 'What date is 3 business days from now?', 'Add 10 working days excluding holidays.'.

Price$0.04per request

MethodPOST

Route/v1/datetime/add-business-days

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

datetimebusiness-daysaddworking-daysholidaysweekendworkdaydate-math

API URLhttps://x402.hexl.dev/v1/datetime/add-business-days

Integration docs

Example request

{
  "date": "2026-01-30",
  "days": 3,
  "holidays": [
    "2026-02-02"
  ]
}

Example response

{
  "start": "2026-01-30",
  "businessDaysAdded": 3,
  "result": "2026-02-05",
  "resultWeekday": "Thursday",
  "nonBusinessDaysSkipped": 3,
  "interpretation": "3 business day(s) from 2026-01-30 lands on 2026-02-05 (Thursday), skipping 3 weekend/holiday day(s)."
}

Input schema

{
  "type": "object",
  "required": [
    "date",
    "days"
  ],
  "properties": {
    "date": {
      "type": "string",
      "examples": [
        "2026-01-30"
      ]
    },
    "days": {
      "type": "integer",
      "examples": [
        3
      ]
    },
    "weekendDays": {
      "type": "array",
      "items": {
        "type": "integer"
      }
    },
    "holidays": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "examples": [
        [
          "2026-02-02"
        ]
      ]
    }
  }
}

Output schema

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