# Holiday Calendar API – Add Business Days

> Holiday Calendar API – Add Business Days is a paid API for AI agents from holidays.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Calculates a future date by adding a specified number of business days to a starting date, skipping weekends and full-day public/bank holidays for a given country or regional subdivision.

## Facts

- Endpoint: GET https://holidays.use.x402atlas.com/add-business-days
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/holiday-calendar-api-add-business-days-1c61357a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s2oXIkOoHUV_QFAxkRA4S

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 holiday-calendar-api-add-business-days-1c61357a
```

Example prompt: What date is 10 business days after 2025-03-01 in Germany (DE), skipping weekends and public holidays?

## When to prefer this

Use this endpoint when you need to calculate a precise future date by adding a set number of business days while correctly accounting for country-specific public and bank holidays. Prefer this over generic date-math libraries when country-specific holiday calendars matter (e.g. SLA windows, payment settlement dates, HR notice periods, legal deadlines). It is especially useful for European and Latin American jurisdictions where regional subdivision holidays differ from national ones.

## Known failure modes

- Invalid or unsupported country code returns an error — only the listed 35 countries are supported
- Date format not in ISO 8601 (YYYY-MM-DD) format causes a validation failure
- Days parameter outside the range 1–366 returns a schema validation error
- Subdivision code that doesn't match the selected country prefix causes an error
- Missing required parameters (country, date, days) returns a 400 bad request

## How this service works

Add business days while skipping weekends and full-day Public or Bank holidays; Optional and HalfDay observances are retained.

## Output

Returns a JSON object containing the computed result date (the date after adding the specified business days), the original start date, the country used, the number of business days added, and a timestamp of when the query was made. Full-day public and bank holidays are excluded; optional and half-day observances are retained in the count.

## 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",
      "date",
      "days"
     ],
     "properties": {
      "date": {
       "type": "string",
       "format": "date",
       "description": "Starting ISO date; counting begins on the following day"
      },
      "days": {
       "type": "integer",
       "maximum": 366,
       "minimum": 1,
       "description": "Number of business days to add"
      },
      "country": {
       "enum": [
        "AD",
        "AL",
        "AT",
        "BE",
        "BG",
        "BR",
        "BY",
        "CH",
        "CZ",
        "DE",
        "EE",
        "ES",
        "FR",
        "HR",
        "HU",
        "IE",
        "IT",
        "LI",
        "LT",
        "LU",
        "LV",
        "MC",
        "MD",
        "MT",
        "MX",
        "NL",
        "PL",
        "PT",
        "RO",
        "RS",
        "SE",
        "SI",
        "SK",
        "SM",
        "VA",
        "ZA"
       ],
       "type": "string",
       "description": "Supported ISO 3166-1 alpha-2 country code: AD Andorra; AL Albania; AT Austria; BE Belgium; BG Bulgaria; BR Brazil; BY Belarus; CH Switzerland; CZ Czechia; DE Germany; EE Estonia; ES Spain; FR France; HR Croatia; HU Hungary; IE Ireland; IT Italy; LI Liechtenstein; LT Lithuania; LU Luxembourg; LV Latvia; MC Monaco; MD Moldova; MT Malta; MX Mexico; NL Netherlands; PL Poland; PT Portugal; RO Romania; RS Serbia; SE Sweden; SI Slovenia; SK Slovakia; SM San Marino; VA Vatican City; ZA South Africa."
      },
      "language": {
       "type": "string",
       "pattern": "^[A-Z]{2}$",
       "description": "Optional two-letter ISO 639-1 result language. Defaults to English when available."
      },
      "subdivision": {
       "type": "string",
       "pattern": "^[A-Z]{2}-.+$",
       "maxLength": 20,
       "description": "Optional regional subdivision code beginning with the selected country code, for example DE-BE."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "country": "DE",
  "queried_at": "2026-07-27T12:00:00Z",
  "start_date": "2026-01-01",
  "result_date": "2026-01-08",
  "subdivision": "DE-BE",
  "business_days": 5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/holiday-calendar-api-add-business-days-1c61357a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from holidays.use.x402atlas.com](https://www.zero.xyz/host/holidays.use.x402atlas.com/llms.txt)