# Agent Time & Place — Business Days Calculator

> Agent Time & Place — Business Days Calculator is a paid API for AI agents from time-place.agent-utils.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Counts business days between two dates or adds/subtracts business days from a start date, accounting for country-specific public holidays and configurable weekends.

## Facts

- Endpoint: GET https://time-place.agent-utils.workers.dev/v1/business-days
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-time-place-business-days-calculator-4fd6c790
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sq1xOn6VnxX-yf_Xyhnil

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 agent-time-place-business-days-calculator-4fd6c790
```

Example prompt: How many business days are there between November 25 and December 31 in the US, accounting for Thanksgiving and Christmas?

## When to prefer this

Choose this endpoint when you need deterministic, holiday-aware business day arithmetic for a specific country or region, especially when you need the list of skipped holidays by name. It requires no API key — payment via x402 is the authentication mechanism, making it suitable for agent pipelines without credential management. Prefer it over generic date libraries when country-specific public holidays matter for accuracy.

## Known failure modes

- Missing required 'country' or 'from' parameters returns a 400 error
- Mutually exclusive 'to' and 'add' parameters both provided causes an error
- Invalid date format (non-ISO 8601) causes a parse error
- Unrecognized country code returns an error or empty holiday list
- Invalid ISO 3166-2 region code may return no regional holidays
- Payment not provided or insufficient returns a 402 Payment Required response

## How this service works

Geocoding, timezones, holidays, business days, sun times, FX and distances for AI agents. Deterministic, sub-cent, no API key: payment is authentication (x402).

## Output

A JSON object containing the computation mode (add or count), the start date, the result date or business day count, the country, total business days, and arrays of skipped holidays (with date, name, local name, types, and regional scope) and skipped weekend days.

## 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",
      "from"
     ],
     "properties": {
      "to": {
       "type": "string",
       "format": "date",
       "description": "Count business days from 'from' to 'to' inclusive."
      },
      "add": {
       "type": "integer",
       "description": "Business days to add (negative to subtract). Mutually exclusive with 'to'."
      },
      "from": {
       "type": "string",
       "format": "date"
      },
      "region": {
       "type": "string",
       "description": "Optional ISO 3166-2 code for regional holidays"
      },
      "country": {
       "type": "string"
      },
      "weekend": {
       "type": "string",
       "default": "sat,sun",
       "description": "Comma list of weekend day names"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "to": {
       "type": "string"
      },
      "from": {
       "type": "string"
      },
      "mode": {
       "enum": [
        "add",
        "count"
       ],
       "type": "string"
      },
      "start": {
       "type": "string"
      },
      "result": {
       "type": "string"
      },
      "country": {
       "type": "string"
      },
      "holidays": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "date": {
          "type": "string",
          "format": "date"
         },
         "name": {
          "type": "string",
          "description": "English name"
         },
         "types": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "regions": {
          "type": [
           "array",
           "null"
          ],
          "items": {
           "type": "string"
          },
          "description": "ISO 3166-2 codes when regional"
         },
         "localName": {
          "type": "string"
         },
         "na
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "add",
  "start": "2026-11-25",
  "result": "2026-12-01",
  "country": "US",
  "businessDays": 3,
  "skippedHolidays": [
   {
    "date": "2026-11-26",
    "name": "Thanksgiving Day",
    "types": [
     "Public"
    ],
    "regions": null,
    "localName": "Thanksgiving Day",
    "nationwide": true
   }
  ],
  "skippedWeekendDays": 2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-time-place-business-days-calculator-4fd6c790/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from time-place.agent-utils.workers.dev](https://www.zero.xyz/host/time-place.agent-utils.workers.dev/llms.txt)