# SiteCheck Business Days Calculator

> SiteCheck Business Days Calculator is a paid API for AI agents from api.sitecheck-api.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-16).

Calculates the number of working days between two dates, or adds/subtracts business days from a date, accounting for weekends and public holidays by country.

## Facts

- Endpoint: GET https://api.sitecheck-api.workers.dev/api/business-days?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-business-days-calculator-9492eda6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O_zzny07pXe4Fp6S-ESKI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sitecheck-business-days-calculator-9492eda6
```

Example prompt: How many business days are there between December 18, 2026 and January 6, 2027 in Germany, skipping weekends and public holidays?

## When to prefer this

Choose this endpoint when you need accurate business day calculations that account for both weekends and country-specific public holidays. It supports multiple countries via ISO codes and offers two modes: counting days between two dates, or projecting a future/past date by a number of working days. Prefer it over manual calendar math or generic date libraries when holiday accuracy per country matters, such as for legal deadlines, SLA tracking, or financial settlement dates.

## Known failure modes

- Missing required 'country' query parameter returns an error
- Invalid country code (not ISO 3166 alpha-2) may return no holiday data or an error
- Missing 'from'/'to' for 'between' mode or missing 'date'/'days' for 'add' mode returns an error
- Days value exceeding 3,650 is rejected
- Invalid date format (not YYYY-MM-DD) causes a parse error
- Payment failure via x402 protocol prevents response

## How this service works

Working days for a country. mode=between counts the working days after `from` up to and including `to` (up to 5 years) and lists the public holidays skipped; mode=add gives the date that is N working days after `date` (up to 3,650). Weekends are Saturday and Sunday, Friday and Saturday in Israel, and Friday only in Iran and Afghanistan. Nationwide public holidays from Nager.Date; a country with no holiday data is a 404, not charged.

## Output

Returns a JSON object with the computed working days count, calendar days count, the from/to dates, mode used, country, list of holidays skipped (with names and dates), weekend day numbers, and a timestamp of when the check was performed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country"
     ],
     "properties": {
      "to": {
       "type": "string",
       "description": "End date YYYY-MM-DD (mode between; counted)"
      },
      "date": {
       "type": "string",
       "description": "Start date YYYY-MM-DD (mode add)"
      },
      "days": {
       "type": "string",
       "description": "Working days to add, negative to subtract, up to 3,650 in size (mode add)"
      },
      "from": {
       "type": "string",
       "description": "Start date YYYY-MM-DD (mode between; not counted)"
      },
      "mode": {
       "type": "string",
       "description": "between (default) or add"
      },
      "country": {
       "type": "string",
       "description": "ISO 3166 alpha-2 code, e.g. DE, US, IL"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2027-01-06",
  "from": "2026-12-18",
  "mode": "between",
  "source": "Computed here; public holidays: Nager.Date (nationwide holidays only)",
  "counted": "after from, up to and including to",
  "country": "DE",
  "checkedAt": "2026-10-15T14:00:29.548Z",
  "weekendDays": [
   0,
   6
  ],
  "workingDays": 11,
  "calendarDays": 19,
  "holidaysSkipped": [
   {
    "date": "2026-12-25",
    "name": "Erster Weihnachtstag"
   },
   {
    "date": "2027-01-01",
    "name": "Neujahr"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-business-days-calculator-9492eda6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.sitecheck-api.workers.dev](https://www.zero.xyz/host/api.sitecheck-api.workers.dev/llms.txt)