Add calendar or business days to a date

GET/v1/date/add

Add calendar or business days to a date

startquery · stringREQUIRED

Start date

e.g. 2026-12-23

daysquery · integerREQUIRED

Days to add (negative to subtract)

e.g. 5

businessquery · boolean

Count business days instead of calendar days

e.g. false

countryquery · string

Country for holidays and weekend definition

e.g. US

subdivisionquery · string

State / province for regional holidays

e.g. string

curl "https://api.apialmanac.com/v1/date/add?start=2026-12-23&days=5" \
  -H "X-API-Key: YOUR_KEY"

import requests

r = requests.get("https://api.apialmanac.com/v1/date/add?start=2026-12-23&days=5", headers={"X-API-Key": "YOUR_KEY"})
print(r.status_code, r.headers.get("X-Gw-Remaining"))
print(r.json())

const r = await fetch("https://api.apialmanac.com/v1/date/add?start=2026-12-23&days=5", {
  headers: { "X-API-Key": "YOUR_KEY" }
});
console.log(r.status, r.headers.get("X-Gw-Remaining"));
console.log(await r.json());

{
  "start": "2026-12-23",
  "days": 5,
  "business": true,
  "result": "2026-12-31",
  "weekday": "Thursday",
  "calendar_days_elapsed": 8,
  "calendar_used": "United States",
  "skipped": [
    {
      "date": "2026-12-25",
      "reason": "Christmas Day"
    },
    {
      "date": "2026-12-26",
      "reason": "weekend"
    },
    {
      "date": "2026-12-27",
      "reason": "weekend"
    }
  ]
}