# BizCal Business Day Calculator

> BizCal Business Day Calculator is a paid API for AI agents from api.firstmention.uk, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-13).

Calculates the number of business days, weekends, and public holidays between two dates for a specified country (US, UK, Germany, France, or Netherlands)

## Facts

- Endpoint: GET https://api.firstmention.uk/s/bizcal-api/workdays?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bizcal-business-day-calculator-38b8f377
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hTGCSP7L6pDzJbKLPS3tm

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 bizcal-business-day-calculator-38b8f377
```

Example prompt: How many business days are there in the US between November 20 and December 5, 2026, and which public holidays fall on weekdays in that period?

## When to prefer this

Use this endpoint when you need accurate business day counts with country-specific public holiday exclusions for US, UK, Germany, France, or Netherlands. Prefer it over generic date-math libraries when official national holiday calendars are required for scheduling, SLA calculation, payroll, or contract deadlines. The pay-per-call x402 model means no subscription needed.

## Known failure modes

- Missing required query parameters (country, start, end) returns validation error
- Country code not in supported enum (US, GB, DE, FR, NL) returns error
- End date before start date may return zero or error
- Malformed date format (not YYYY-MM-DD) returns schema validation error
- Payment failure via x402 returns 402 Payment Required
- Very large date ranges may include only holidays within the range

## How this service works

Pay-per-call HTTP APIs, paid with x402 in USDC on Base (eip155:8453): agentkit, api-change-check, basedue, bizcal-api, chainread, check-sanctions, chgwatch, company-facts, domain-intel, domainkit, domfacts, due, edgar, funding-rates, fundinglens, pageaudit, solcheck, token-dd, txpreflight, walletprofile, web-extract, webmd, webread, websearch, x402-preflight, x402check, x402index. Each operation describes its service.

## Output

A JSON object containing: the start and end dates, country code, total calendar days, weekend days, business days (weekdays minus public holidays), count of weekday holidays, and an array of public holiday objects (each with date, holiday name, and day of week) that fall on weekdays within the range.

## 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"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "start",
      "end"
     ],
     "properties": {
      "end": {
       "type": "string",
       "description": "End date YYYY-MM-DD"
      },
      "start": {
       "type": "string",
       "description": "Start date YYYY-MM-DD"
      },
      "country": {
       "type": "string",
       "description": "US, GB, DE, FR or NL"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "end": {
       "type": "string"
      },
      "start": {
       "type": "string"
      },
      "country": {
       "type": "string"
      },
      "weekend_days": {
       "type": "number"
      },
      "business_days": {
       "type": "number"
      },
      "calendar_days": {
       "type": "number"
      },
      "weekday_holidays": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "EUR",
  "date": "2026-11-02",
  "kind": "latest",
  "rates": {
   "GBP": 0.8421,
   "USD": 1.0765
  },
  "source": "European Central Bank reference rates",
  "symbols": [
   "USD",
   "GBP"
  ],
  "converted": {
   "GBP": 84.21,
   "USD": 107.65
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bizcal-business-day-calculator-38b8f377/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.firstmention.uk](https://www.zero.xyz/host/api.firstmention.uk/llms.txt)
