# Business Day Checker with Weekend & Public Holiday Validation

> Business Day Checker with Weekend & Public Holiday Validation is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-01).

Checks whether a given date is a business day for a specified country (accounting for weekends and public holidays) and returns the next valid business day

## Facts

- Endpoint: POST https://twin.unykorn.org/geo/business-day?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/business-day-checker-with-weekend-public-holiday-validation-480a6c0a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qm2FelpP8qxucIaYyYWnQ

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 business-day-checker-with-weekend-public-holiday-validation-480a6c0a -d '<json body>'
```

Example prompt: Is December 26 a business day in the UK, and if not, what's the next business day?

## When to prefer this

Use this endpoint when you need to determine business day validity for a specific country with public holiday awareness, especially for scheduling payments, SLAs, contract dates, or any workflow that must avoid weekends and national holidays. Prefer this over a simple weekday check when public holidays matter and when you need the next business day fallback date.

## Known failure modes

- Missing or invalid country ISO-2 code returns an error
- Invalid date format (not YYYY-MM-DD) causes a parse error
- Unsupported or unrecognized country codes may return incomplete holiday data
- Edge cases around regional holidays (state/province-level) may not be covered

## How this service works

Is it a business day? Weekend + public-holiday check with next business day — Genesis402 / UnyKorn Operator Network

## Output

Returns a JSON object indicating whether the queried date is a business day for the given country, whether it falls on a weekend or public holiday (with holiday name if applicable), and the date of the next valid business day.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "date": {
     "type": "string",
     "description": "optional YYYY-MM-DD, default today (UTC)"
    },
    "country": {
     "type": "string",
     "description": "required ISO-2"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "business-day",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.001,
   "receipt_id": "g402-<16hex>"
  },
  "sources": [
   {
    "ok": true,
    "name": "<source>"
   }
  ],
  "limitations": "<text>",
  "generated_at": "<iso time>",
  "evidence_hash": "sha256:<64hex>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/business-day-checker-with-weekend-public-holiday-validation-480a6c0a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)