# Public Holiday & Business Day API (100+ Countries)

> Public Holiday & Business Day API (100+ Countries) is a paid API for AI agents from x402.donnyautomation.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns public and bank holidays for a given country and year, and answers whether a specific date is a business day with next/previous business day navigation.

## Facts

- Endpoint: GET https://x402.donnyautomation.com/holidays
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/public-holiday-business-day-api-100-countries-e0de60be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6BQdQCIqrsMWuUjc6URZ7

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 public-holiday-business-day-api-100-countries-e0de60be
```

Example prompt: Is March 17 2025 a business day in Ireland, and if not, what are the nearest business days on either side?

## When to prefer this

Choose this endpoint when you need authoritative public and bank holiday data for 100+ countries with direct business-day computation built in — avoiding the need to implement your own weekend/holiday walking logic. It is especially useful for settlement, payroll, SLA, and scheduling agents that need to cross year boundaries or handle regional holiday distinctions in a single call.

## Known failure modes

- Missing or invalid country code returns an error — must be ISO 3166-1 alpha-2
- Year outside supported range 1975–2100 may return an error or empty result
- Invalid date format (not YYYY-MM-DD) returns a parsing error
- Network or payment (x402) failure prevents the response
- Some countries may have incomplete or unofficial regional holiday data

## How this service works

Public and bank holidays for 100+ countries, and the business-day answer behind them. Returns holidays[] with localName, name, global and types; pass ?date= and it also answers isBusinessDay with nextBusinessDay and previousBusinessDay, walking weekends and year boundaries. Requires ?country=<ISO 3166-1 alpha-2, e.g. US>; optional ?date=YYYY-MM-DD or ?year=1975..2100. Errors: 400 bad_country (a 3-letter code like USA is rejected)|bad_date|bad_year, 404 unknown_country.

## Output

A list of holidays for the country and year with each holiday's local name, English name, date, whether it is nationwide, and which regions observe it. When a date is supplied, also returns a boolean isBusinessDay flag plus the dates of the next and previous business days (crossing weekends and holidays, including across year boundaries).

## 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": {
      "date": {
       "type": "string",
       "description": "YYYY-MM-DD. Adds the isBusinessDay answer plus next and previous business days."
      },
      "year": {
       "type": "string",
       "description": "Calendar year 1975..2100 (default: current year). Ignored when date is given."
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 country code, e.g. US, GB, DE, JP."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": "2026-08-03T00:00:00.000Z",
  "year": 2026,
  "count": 1,
  "country": "US",
  "holidays": [
   {
    "date": "2026-07-03",
    "name": "Independence Day",
    "types": [
     "Public"
    ],
    "global": true,
    "localName": "Independence Day"
   }
  ],
  "attribution": "Holiday data from Nager.Date (public domain).",
  "businessDay": {
   "date": "2026-07-04",
   "reason": "weekend",
   "weekday": "Saturday",
   "isBusinessDay": false,
   "nextBusinessDay": "2026-07-06",
   "previousBusinessDay": "2026-07-02"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/public-holiday-business-day-api-100-countries-e0de60be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.donnyautomation.com](https://www.zero.xyz/host/x402.donnyautomation.com/llms.txt)