Business-day calculator (holiday-aware) API

Add N working days to a date, or count working days between two dates — skipping weekends AND that country's public holidays (via Nager.Date). The holiday awareness is the moat; plain weekday math is trivial, this isn't. Answers '5 business days from today in Germany', 'working days between these dates', 'when is this due in business days'.

Price$0.01per request

MethodPOST

Route/v1/data/business-day

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache86400s public

databusiness-dayworking-dayscalendarholidaysschedulingdate-mathsla

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

Integration docs

Example request

{
  "op": "add",
  "date": "2026-06-02",
  "days": 5,
  "country": "US"
}

Example response

{
  "op": "add",
  "country": "US",
  "from": "2026-06-02",
  "businessDays": 5,
  "result": "2026-06-09",
  "resultWeekday": "Tue"
}

Input schema

{
  "type": "object",
  "required": [
    "op"
  ],
  "properties": {
    "op": {
      "type": "string",
      "enum": [
        "add",
        "between"
      ]
    },
    "date": {
      "type": "string",
      "examples": [
        "2026-06-02"
      ]
    },
    "days": {
      "type": "number",
      "examples": [
        5
      ]
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "country": {
      "type": "string",
      "default": "US",
      "examples": [
        "DE"
      ]
    }
  }
}

Output schema

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