# Business Days Calculator

> Business Days Calculator is a paid API for AI agents from x402-data-api-x6da.onrender.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-19).

Calculates business days between two dates or adds/subtracts working days from a start date, accounting for public holidays by country and subdivision.

## Facts

- Endpoint: GET https://x402-data-api-x6da.onrender.com/v1/time/business-days?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/business-days-calculator-af266c74
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wb6Rw5xdk-rWi0_lqGh_t

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-af266c74
```

Example prompt: What date will it be exactly 10 business days from December 22, 2026 in the US, and which holidays get skipped along the way?

## When to prefer this

Choose this endpoint when you need to calculate working-day deadlines or offsets with accurate public holiday data for a specific country or US state/Canadian province, without setting up your own holiday library. It is especially useful for multi-country scheduling where holiday calendars differ, and for AI agents that need cheap, stateless, pay-per-call date arithmetic without API key management.

## Known failure modes

- Invalid date format (not YYYY-MM-DD) returns an error
- Unsupported country code returns an error or falls back to US
- Invalid subdivision code for a given country returns an error
- Missing required start parameter returns a validation error
- Providing both 'end' and 'days' parameters simultaneously may cause ambiguous behavior
- Payment failure via x402 results in HTTP 402 before computation occurs

## How this service works

Pay-per-call data and web utilities for AI agents: web page to Markdown, SEO audit, email check, domain RDAP/DNS and mail security, ECB FX rates, time zones and business days, SEC EDGAR search and fundamentals, Federal Register, USAspending, weather and NWS alerts, VIN, NPI, ATS jobs. USDC on Base via x402, no sign-up.

## Output

A JSON object containing the calculated result date (YYYY-MM-DD), the weekday name of that result, the number of days added/counted, the start date, whether the start date is itself a business day, a list of holidays skipped (with dates and names), the country and subdivision used, and the data source attribution.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "end": {
       "type": "string",
       "description": "YYYY-MM-DD; if set, counts working days between"
      },
      "days": {
       "type": "integer",
       "description": "working days to add (negative to subtract)"
      },
      "start": {
       "type": "string",
       "description": "YYYY-MM-DD"
      },
      "subdiv": {
       "type": "string",
       "description": "state/province code, e.g. CA"
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2, default US"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "days": {
       "type": "number"
      },
      "start": {
       "type": "string"
      },
      "result": {
       "type": "string"
      },
      "source": {
       "type": "string"
      },
      "subdiv": {},
      "country": {
       "type": "string"
      },
      "result_weekday": {
       "type": "string"
      },
      "holidays_skipped": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "date": {
          "type": "string"
         },
         "name": {
          "type": "string"
         }
        }
       }
      },
      "start_is_business_day": {
       "type": "boolean"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "days": 5,
  "start": "2026-12-22",
  "result": "2026-12-30",
  "source": "python-holidays (MIT licence)",
  "subdiv": null,
  "country": "US",
  "result_weekday": "Wednesday",
  "holidays_skipped": [
   {
    "date": "2026-12-25",
    "name": "Christmas Day"
   }
  ],
  "start_is_business_day": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/business-days-calculator-af266c74/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-data-api-x6da.onrender.com](https://www.zero.xyz/host/x402-data-api-x6da.onrender.com/llms.txt)
