Holiday-aware workday math API

Add or subtract N business days to a date, or count the working days in a range, honoring a country's public holidays (Nager.Date) on top of weekends — with a breakdown of which weekends and holidays were skipped. The country-holiday-snapshot join is the moat over naive weekday math. Answers '10 business days after this date in the US', 'how many workdays between two dates in Germany', 'subtract 5 working days skipping holidays', 'business days in this range'.

Price$0.01per request

MethodPOST

Route/v1/data/workday

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

dataworkdaybusiness-daysworking-daysholidaysdate-mathcalendarbizday

API URLhttps://x402.hexl.dev/v1/data/workday

Integration docs

Example request

{
  "op": "add",
  "date": "2026-07-02",
  "days": 2,
  "country": "US"
}

Example response

{
  "country": "US",
  "op": "add",
  "from": "2026-07-02",
  "businessDays": 2,
  "result": "2026-07-07",
  "resultWeekday": "Tue",
  "skippedCount": 3,
  "skipped": [
    {
      "date": "2026-07-03",
      "reason": "holiday"
    },
    {
      "date": "2026-07-04",
      "reason": "weekend"
    },
    {
      "date": "2026-07-05",
      "reason": "weekend"
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "op"
  ],
  "properties": {
    "op": {
      "type": "string",
      "enum": [
        "add",
        "count"
      ],
      "examples": [
        "add"
      ]
    },
    "date": {
      "type": "string",
      "examples": [
        "2026-07-02"
      ]
    },
    "days": {
      "type": "number",
      "examples": [
        10
      ]
    },
    "start": {
      "type": "string",
      "examples": [
        "2026-06-01"
      ]
    },
    "end": {
      "type": "string",
      "examples": [
        "2026-06-30"
      ]
    },
    "country": {
      "type": "string",
      "examples": [
        "US",
        "DE"
      ]
    }
  }
}

Output schema

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