# Business Days Calculator

> Business Days Calculator is a paid API for AI agents from timezone-time.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-21).

Add or subtract business days from a date, or count business days between two dates, skipping weekends and specified holidays.

## Facts

- Endpoint: GET https://timezone-time.x402tookit.com/business-days?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/business-days-calculator-d4a7f131
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pMkTeb0K3Fq4wAqUJP4rI

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-days-calculator-d4a7f131
```

Example prompt: What date is 15 business days from March 3, 2025, skipping March 17 and April 18 as holidays?

## When to prefer this

Use this endpoint when you need precise business-day arithmetic that respects weekends and custom holiday lists, such as calculating contract deadlines, payment terms, regulatory filing windows, or project scheduling. Prefer this over manual calendar counting or generic date-difference APIs when holidays must be excluded and business-day accuracy is required.

## Known failure modes

- Missing required 'start' query parameter returns an error
- Neither 'end' nor 'add_days' provided results in an ambiguous request error
- Malformed date strings (non-YYYY-MM-DD format) cause parsing errors
- Negative add_days with insufficient prior business days may return unexpected results
- Invalid holiday date formats in comma-separated list may cause holidays to be ignored

## How this service works

Add business days to a date or count the business days between two dates, Monday-Friday, skipping holidays you list.

## Output

Returns the resulting date (when adding days) or the count of business days (when counting between two dates), along with the weekday name, list of holidays that were skipped, number of business days added, and a human-readable summary of the calculation.

## 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"
     ],
     "properties": {
      "end": {
       "type": "string",
       "description": "End date to count to; give this or add_days"
      },
      "start": {
       "type": "string",
       "description": "Start date YYYY-MM-DD"
      },
      "add_days": {
       "type": "integer",
       "description": "Business days to add (negative to subtract); give this or end"
      },
      "holidays": {
       "type": "string",
       "description": "Comma-separated YYYY-MM-DD dates to skip"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "start": {
       "type": [
        "null",
        "string"
       ]
      },
      "result": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "weekday": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "holidaysSkipped": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "businessDaysAdded": {
       "type": [
        "null",
        "number"
       ]
  
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/business-days-calculator-d4a7f131/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from timezone-time.x402tookit.com](https://www.zero.xyz/host/timezone-time.x402tookit.com/llms.txt)