# Business Day Date Calculator

> Business Day Date Calculator is a paid API for AI agents from agents.crowdspark.me, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-31).

Adds or subtracts N business days from a given date, skipping weekends and public holidays for a specified country, returning the result date, weekday, skipped holidays, and working-day status.

## Facts

- Endpoint: GET https://agents.crowdspark.me/v1/time/add-business-days?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/business-day-date-calculator-13d5caf4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B2bDTjd2vc1uwwBlqP-yb

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-date-calculator-13d5caf4
```

Example prompt: What date is 20 business days after December 23, 2026 in the US, skipping weekends and public holidays?

## When to prefer this

Choose this endpoint when you need to compute a forward or backward date that skips weekends and country-specific public holidays — ideal for SLA tracking, invoice terms, shipping ETAs, legal deadlines, and payroll cutoffs. Prefer this over generic date-math tools when country-specific holiday calendars are required.

## Known failure modes

- Missing required 'start' or 'days' parameter returns an error
- Invalid date format (non-YYYY-MM-DD) causes a parse error
- Invalid or unsupported ISO country code may return no holiday data or an error
- 'days' value exceeding 1000 is rejected
- Non-integer or malformed 'days' value returns a validation error
- Payment not satisfied returns HTTP 402

## How this service works

Pay-per-call utilities for AI agents over x402, USDC on Base.

## Output

A JSON object with the computed result date (YYYY-MM-DD), its weekday name, a list of public holidays skipped (each with date and name), the number of weekend days skipped, total calendar days elapsed, the number of business days requested, the start date and its weekday, and whether the start date itself is a business day.

## 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": "Whole number of business days, negative to go back (max 1000)"
      },
      "start": {
       "type": "string",
       "description": "Start date YYYY-MM-DD (not counted)"
      },
      "country": {
       "type": "string",
       "description": "Optional ISO 3166 alpha-2, e.g. US"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "days": 5,
  "start": "2026-12-23",
  "result": "2026-12-31",
  "country": "US",
  "calendar_days": 8,
  "start_weekday": "Wednesday",
  "result_weekday": "Thursday",
  "holidays_skipped": [
   {
    "date": "2026-12-25",
    "name": "Christmas Day"
   }
  ],
  "weekend_days_skipped": 2,
  "start_is_business_day": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/business-day-date-calculator-13d5caf4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.crowdspark.me](https://www.zero.xyz/host/agents.crowdspark.me/llms.txt)