Skip to content

Business days by country

$0.002 per callUSDC via x402GET /api/country-business-days

Holiday-aware business days for a country or region: check whether a date is a business day, add or subtract N business days, or count business days between two dates. Send GET /api/country-business-days with the required field country and pay $0.002 per call over x402 or MPP (there is no free tier). It returns a JSON object with country, subdivision, op, date, days and 5 more.

Uses the country's public (or bank) holidays, a published observance rule where one exists (US federal, UK substitute days, Japan substitute holidays), and a weekend you can override. ?country=US&op=add&date=2026-07-02&days=1. Holiday data by Nager.Date.

Category: Time & schedulingTags: business-days working-days holidays settlement calendar time

Try in playground →

Parameters

NameTypeRequiredDescription
countrystringyesISO 3166-1 alpha-2 country code Also accepted as countryCode, country_code, cc, iso, nation.
subdivisionstringnooptional ISO 3166-2 region whose own holidays also close business
opstring (one of: check, add, count)nocheck a date, add N business days, or count between from and to (default check)
datestringnoYYYY-MM-DD for check and add
daysintegernobusiness days to add (negative subtracts), -1000 to 1000
fromstringnocount: start date, counted
tostringnocount: end date, not counted (at most 3 years after from)
basisstring (one of: public, bank)nowhich holidays close business (default public; bank falls back to public where none are tagged)
weekendstringnooptional weekend days, e.g. Fri,Sat (default Sat,Sun)

Example request

curl -i "https://agent402.tools/api/country-business-days?country=US&op=add&date=2026-07-02&days=1"

Without payment this returns HTTP 402 Payment Required with the exact price for country-business-days; any x402 v2 or MPP client pays it and retries.

Watch a call get paid

RequestGET /api/country-business-days
402$0.002 USDC
SignPAYMENT-SIGNATURE
Settleon 14 chains
Answer200 OK
ReceiptAgent402-ReceiptEd25519

Example response

{
  "country": "US",
  "subdivision": null,
  "op": "add",
  "date": "2026-07-02",
  "days": 1,
  "result": "2026-07-06",
  "skipped": [
    {
      "date": "2026-07-03",
      "reason": "holiday",
      "name": "Independence Day",
      "observedFrom": "2026-07-04"
    },
    {
      "date": "2026-07-04",
      "reason": "holiday",
      "name": "Independence Day"
    },
    {
      "date": "2026-07-05",
      "reason": "weekend"
    }
  ],
  "basis": "public",
  "weekend": [
    "Sat",
    "Sun"
  ],
  "observance": {
    "id": "us-federal",
    "rule": "Saturday holiday observed the preceding Friday; Sunday holiday observed the following Monday",
    "source": "https://www.opm.gov/policy-data-oversight/pay-leave/federal-holidays/"
  }
}
FieldTypeAlways presentIn the example
countrystringyesUS
subdivisionnullnonull
opstringyesadd
datestringyes2026-07-02
daysnumberyes1
resultstringyes2026-07-06
skippedarray of objectsyes3 items in the example
basisstringyespublic
weekendarray of stringyes2 items in the example
observanceobjectyes3 fields: id, rule, source

From an MCP client

catalog.call {
  "slug": "country-business-days",
  "params": {
    "country": "US",
    "op": "add",
    "date": "2026-07-02",
    "days": 1
  }
}

The hosted connector at https://agent402.tools/mcp needs a payment for country-business-days; the stdio package pays it from a wallet or from an AGENT402_CREDITS_KEY issued earlier. Local install: npx -y agent402-mcp@0.14.0.

Errors and behavior

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
client.setSpendControls?.({ maxAmountPerPayment: "$0.002" }); // refuse any quote above this tool's price
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/country-business-days?country=US&op=add&date=2026-07-02&days=1");

Related tools

Bank holidays

$0.001GET /api/bank-holidays

Bank holidays for a country and year (optionally one region): the days the holiday dataset tags as bank holidays.

Cross-border business-day planner

$0.003GET /api/business-day-planner

First dates on or after a start date that are business days in every listed country or region at once (up to 6, e.g.

Long weekends

$0.001GET /api/long-weekends

Long weekends in a country's year, computed from its public holidays: every run of 3 or more consecutive days off that.

Next holidays

$0.001GET /api/next-holidays

Upcoming holidays in a country over the next 365 days, soonest first, optionally narrowed to one region and to holiday.

Public holidays

$0.001GET /api/public-holidays

Public holidays for a country and year from an open public-holiday dataset (keyless, 100+ countries): observed date.

School holidays

$0.001GET /api/school-holidays

School holiday days for a country and year (optionally one region): the single days the holiday dataset tags as school.