# EU Agent Utils – European Business Days Calculator

> EU Agent Utils – European Business Days Calculator is a paid API for AI agents from eu-agent-utils.frcompanycheck.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Counts working days between two dates or adds N business days to a start date, accounting for public holidays across 8 European countries (including FR Alsace-Moselle subdivisions)

## Facts

- Endpoint: GET https://eu-agent-utils.frcompanycheck.workers.dev/v1/business-days?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-agent-utils-european-business-days-calculator-4e8d0963
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UKttbYOZuBMfhbgEOGuz3

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 eu-agent-utils-european-business-days-calculator-4e8d0963
```

Example prompt: How many business days are there between December 1 and December 31, 2026 in France? Include Alsace-Moselle holidays since we're in the FR-67 subdivision.

## When to prefer this

Choose this endpoint when you need authoritative, offline-deterministic business day calculations for one of the 8 supported European countries (FR, BE, LU, DE, AT, IT, ES, PT), especially when French Alsace-Moselle regional holidays matter. It requires no account or API key, charges only $0.003 USDC per successful call via x402, and errors are never billed. Prefer it over generic date libraries when you need country-specific public holiday data baked in.

## Known failure modes

- Missing required 'country' or 'from' query parameter returns an error (not charged)
- Invalid date format (non-YYYY-MM-DD) returns a parsing error (not charged)
- Unsupported country code returns an error (not charged)
- Invalid subdivision code for France returns an error (not charged)
- Conflicting parameters (both 'to' and 'add' supplied) may return an error (not charged)
- Payment failure via x402 results in 402 response and no computation

## How this service works

Cheap, deterministic utilities for AI agents, paid per call in USDC with x402 (no account, no API key): ECB euro reference FX rates and conversion, IANA time-zone conversion with explicit DST handling, European public holidays and working-day calculator (FR incl. Alsace-Moselle, BE, LU, DE, AT, IT, ES, PT), offline IBAN validation, and SIREN/SIRET and EU VAT number check-digit validation. Errors are never charged.

## Output

A JSON object containing the start date, end date or computed result date, the mode (count or add), the country, the number of business days, the number of calendar days, and an array of public holidays that fall on weekdays within the range (each with date and name).

## 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",
       "example": "2026-12-31",
       "description": "End date (count mode)"
      },
      "add": {
       "type": "integer",
       "description": "N business days to add (may be negative) (add mode)"
      },
      "from": {
       "type": "string",
       "example": "2026-12-01",
       "description": "Start date YYYY-MM-DD"
      },
      "country": {
       "type": "string",
       "example": "FR",
       "description": "FR, BE, LU, DE, AT, IT, ES or PT"
      },
      "subdivision": {
       "type": "string",
       "description": "Optional FR-57/FR-67/FR-68"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2026-12-31",
  "from": "2026-12-01",
  "mode": "count",
  "country": "FR",
  "business_days": 22,
  "calendar_days": 31,
  "holidays_on_weekdays": [
   {
    "date": "2026-12-25",
    "name": "Christmas Day"
   }
  ]
 }
}
```

## More

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