# Agent402 UK Business Day Calculator

> Agent402 UK Business Day Calculator is a paid API for AI agents from agent402.co.uk, paid per call via x402, $0.001/call, status down (last checked 2026-10-12).

Adds or subtracts N business days from a start date, optionally accounting for UK bank holidays by region

## Facts

- Endpoint: GET https://agent402.co.uk/v1/time/add-business-days?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-uk-business-day-calculator-09383f66
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2Zy7D-zCNHYB-Px8MroKa

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 agent402-uk-business-day-calculator-09383f66
```

Example prompt: What date is 10 business days from 2025-06-01, accounting for England and Wales bank holidays?

## When to prefer this

Choose this endpoint when you need accurate business-day arithmetic that accounts for real UK bank holidays sourced from GOV.UK, rather than hand-coded or estimated holiday lists. Ideal for SLA calculations, invoice payment terms, contract notice periods, regulatory deadlines, and any cut-off math in a UK business context. Prefer this over generic date calculators when UK regional holiday variations (England and Wales vs Scotland vs Northern Ireland) matter for correctness.

## Known failure modes

- Invalid start date format (not YYYY-MM-DD) returns a 400 error
- Non-integer or missing days parameter causes a validation error
- Unsupported region string returns an error or falls back to no holidays
- GOV.UK bank holiday API unavailability may cause holiday data to be missing or stale
- Negative days value that overshoots the start date may return unexpected early dates

## How this service works

Don't burn tokens on deterministic work. Go/no-go jobs first: payout preflight, text firewall (PII/secrets), budget check — then rails, calendars, finmath. x402 USDC on Base. UK + global. agent402.co.uk — not agent402.tools. $0.001–$0.002 USDC on Base. No API keys.

## Output

Returns the resulting date after adding or subtracting the specified number of business days from the start date, with weekends and any relevant UK bank holidays (fetched from GOV.UK) excluded from the count. Typically includes the result date in YYYY-MM-DD format and may include details about which holidays were skipped.

## 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": [
      "start",
      "days"
     ],
     "properties": {
      "days": {
       "type": "string",
       "description": "Business days to add (negative = backward)"
      },
      "start": {
       "type": "string",
       "description": "Start date YYYY-MM-DD"
      },
      "region": {
       "type": "string",
       "description": "england-and-wales | scotland | northern-ireland"
      },
      "country": {
       "type": "string",
       "description": "GB|UK enables UK holidays"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "days": 3,
  "start": "2026-08-28",
  "region": "england-and-wales",
  "result": "2026-09-03"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-uk-business-day-calculator-09383f66/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.co.uk](https://www.zero.xyz/host/agent402.co.uk/llms.txt)