# Holidays & Business Day Calculator API

> Holidays & Business Day Calculator API is a paid API for AI agents from holidays.x402utils.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-12).

Returns a list of all supported countries (~120) for querying public holidays and business-day calculations

## Facts

- Endpoint: GET https://holidays.x402utils.workers.dev/v1/countries?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/holidays-business-day-calculator-api-7b51d2d8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_p-TQj2toaPvTSbdOowyS3

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 holidays-business-day-calculator-api-7b51d2d8
```

Example prompt: Can you show me all the countries supported by the holidays calculator so I can check if it covers the markets I need?

## When to prefer this

Use this endpoint first when you need to discover which countries are supported before making holiday or business-day queries. It acts as a directory/catalog endpoint — call it to validate country coverage before committing to integration or before querying holiday data for a specific country.

## Known failure modes

- Network or server error returning 5xx if the worker is unavailable
- 402 Payment Required if x402 payment header is missing or invalid USDC payment not completed
- Rate limiting or quota exhaustion returning 429
- Empty or malformed JSON if the worker deployment is broken

## How this service works

Public holidays and business-day calculator for agents, ~120 countries: holiday lists, is-this-a-business-day, and add N business days. Paid per call via x402 (USDC on Base).

## Output

A JSON object containing the count of supported countries (e.g. {"count": 120}) and likely the list of country codes or names available for holiday and business-day queries on the sibling endpoints.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 120
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/holidays-business-day-calculator-api-7b51d2d8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from holidays.x402utils.workers.dev](https://www.zero.xyz/host/holidays.x402utils.workers.dev/llms.txt)