Business Day Check

Check whether a date is a business day in a country, counting weekends and public holidays. Returns the next business day when it is not.

Pay by wallet (x402) business-day-check

Example

Example answer

{
  "date": "2026-12-25",
  "reason": "public_holiday: Christmas Day",
  "country_code": "SE",
  "is_business_day": false,
  "next_business_day": "2026-12-28",
  "previous_business_day": "2026-12-23"
}

Inputs

Field	Type	Required	What it is
`date`	string	Yes	Date to check (YYYY-MM-DD)
`country_code`	string	Yes	ISO 2-letter country code

Output fields

How reliably each field appears in a successful answer.

Field	Type	Appears
`reason`	string	Usually (present for most inputs)
`is_business_day`	boolean	Always (present in every successful answer)
`next_business_day`	string	Always (present in every successful answer)
`previous_business_day`	string	Always (present in every successful answer)
`date`	—	Always (present in every successful answer)
`country_code`	—	Always (present in every successful answer)

How to call it

The same tool through each route. MCP clients reach it through Strale’s server at https://api.strale.io/mcp; the call below is what the agent sends.

# Needs an API key. max_price_cents caps what this call may cost.
curl -X POST https://api.strale.io/v1/do \
  -H "Authorization: Bearer $STRALE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "capability_slug": "business-day-check",
    "inputs": {
      "date": "2025-12-25",
      "country_code": "SE"
    },
    "max_price_cents": 2
  }'

{
  "tool": "strale_execute",
  "arguments": {
    "slug": "business-day-check",
    "inputs": {
      "date": "2025-12-25",
      "country_code": "SE"
    },
    "max_price_cents": 2
  }
}

import { Strale } from "straleio";

const strale = new Strale({ apiKey: process.env.STRALE_API_KEY! });
const result = await strale.do({
  capability_slug: "business-day-check",
  inputs: {
    "date": "2025-12-25",
    "country_code": "SE"
  },
  max_price_cents: 2,
});

import os
from straleio import Strale, DoRequest

strale = Strale(api_key=os.environ["STRALE_API_KEY"])
result = strale.do(DoRequest(
    capability_slug="business-day-check",
    inputs={
        "date": "2025-12-25",
        "country_code": "SE",
    },
    max_price_cents=2,
))

# No account. The first request answers 402 with the price in USDC;
# an x402 client pays it from your wallet and repeats the request.
curl -i 'https://api.strale.io/x402/v2/business-day-check?date=2025-12-25&country_code=SE'

Limitations

Weekend definition varies by country
Uses standard Sat-Sun weekends for most countries; Fri-Sat for Middle Eastern countries. Some countries with mixed weekends may not be fully accurate.
Holiday data from Nager.Date
Depends on Nager.Date API for holiday data — if the API is unreachable, only weekends are checked