# 402utils Business Day Calculator

> 402utils Business Day Calculator is a paid API for AI agents from 402utils.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Counts working days, weekend days, and holidays in a date range, or shifts a date forward by N business days, using official public holiday calendars for 8 European and North American countries.

## Facts

- Endpoint: GET https://402utils.com/v1/business-days
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/402utils-business-day-calculator-50c2c59b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j-xNInTrL9HN6e-7vu_oD

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 402utils-business-day-calculator-50c2c59b
```

Example prompt: How many business days are there between March 3 2026 and April 30 2026 in Germany, using the Bavaria region calendar? List any public holidays that fall on weekdays in that period.

## When to prefer this

Use this endpoint when you need authoritative business-day calculations tied to official national and regional public holiday calendars for FR, DE, GB, US, ES, IT, NL, or BE, especially for financial, legal, or contractual deadline math where holidays must be excluded by name. Prefer over generic date libraries when country-specific or region-specific holiday data is required for dates in 2025-2027.

## Known failure modes

- Missing required 'country' or 'from' parameter returns 400 error
- Neither 'to' nor 'add' provided returns 400 — exactly one is required
- Unsupported country code (outside FR, DE, GB, US, ES, IT, NL, BE) returns 400 or 422
- Date out of supported range (outside 2025-2027) returns 400
- Invalid region code for the given country returns 400
- Malformed date format (not YYYY-MM-DD) returns 400
- 'add' value outside 1-780 range returns 400
- Payment not included or insufficient returns 402

## How this service works

Business-day math with real holiday calendars for FR, DE, GB, US, ES, IT, NL, BE (2025-2027, official sources — same datasets as /v1/holidays). Count working/weekend/holiday days in a date range (?from&to&country) or shift a date by N business days (?from&add=10&country). Weekend configurable (?weekend=fri,sat), optional ?region= for Länder/UK divisions. Holidays that suppress a working day are listed by name.

## Output

Returns the count of business days, weekend days, and calendar days in the range (or the resulting date after shifting), plus a list of named public/bank holidays on weekdays that were excluded, with optional regional holiday coverage and configurable weekend definition.

## 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",
      "from"
     ],
     "properties": {
      "to": {
       "type": "string",
       "description": "Inclusive end date — range mode."
      },
      "add": {
       "type": "integer",
       "description": "Business days to add — shift mode (1-780)."
      },
      "from": {
       "type": "string",
       "description": "Start date, YYYY-MM-DD (2025-2027)."
      },
      "region": {
       "type": "string",
       "description": "Optional ISO 3166-2 region (e.g. DE-BY, GB-SCT)."
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2: FR, DE, GB, US, ES, IT, NL, BE."
      },
      "weekend": {
       "type": "string",
       "description": "Comma list of weekend days (default sat,sun)."
      }
     },
     "description": "Query params. `country`, `from` and exactly one of `to` / `add` required."
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "country",
      "weekend",
      "from"
     ],
     "properties": {
      "to": {
       "type": "string",
       "description": "Range mode only."
      },
      "add": {
       "type": "integer",
       "description": "Shift mode only."
      },
      "from": {
       "type": "string"
      },
      "note": {
       "type": "string",
       "description": "Dataset-level caveat when applicable."
      },
      "region": {
       "type": "string"
      },
      "result": {
       "type": "string",
       "description": "Shift mode: the date N business days after `from`."
      },
      "country": {
       "type": "string"
      },
      "weekend": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "holidays": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "date",
         "name",
         "localName"
        ],
        "properties": {
  
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2026-07-31",
  "from": "2026-07-01",
  "country": "FR",
  "weekend": [
   "sat",
   "sun"
  ],
  "holidays": [
   {
    "date": "2026-07-14",
    "name": "Bastille Day",
    "localName": "Fête nationale (14 juillet)"
   }
  ],
  "weekendDays": 8,
  "businessDays": 22,
  "calendarDays": 31
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/402utils-business-day-calculator-50c2c59b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 402utils.com](https://www.zero.xyz/host/402utils.com/llms.txt)