80trust / 100

Calendar Holidays

by 2s in Productivity & SaaS

x402 APIPassing, checked 3 h ago

List the official holidays for a country and year, with exact observed dates including substitute days (e.g. a Saturday July 4th observed on Friday). Query: country (ISO 3166-1 alpha-2, 200+ supported), year, optional region (subdivision code like CA for US-California or BY for DE-Bavaria), optional types filter (public, bank, school, optional, observance — comma-separated), optional lang (ISO 639-1) for localized names. Returns one item per holiday: { date (YYYY-MM-DD), name, type, substitute, rule }. Dates are computed from maintained per-country rules — including movable feasts and lunar-calendar holidays — so they stay correct year over year. Use for scheduling, delivery estimates, payment terms, and SLA math.

GET https://2s.io/api/calendar/holidays

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
161 ms typical, 302 ms slowest 5%
Last check
3 h ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X GET "https://2s.io/api/calendar/holidays?country=US&types=public&year=2026"
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.005:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2F2s.io%2Fapi%2Fcalendar%2Fholidays
const res = await pay("https://2s.io/api/calendar/holidays?country=US&types=public&year=2026");
console.log(await res.json());

Example input

{
  "country": "US",
  "types": "public",
  "year": "2026"
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
3 h agoPassed402302 ms$0.0025
6 h agoPassed402156 ms$0.0025
10 h agoPassed402154 ms$0.0025
14 h agoPassed402538 ms$0.0025
17 h agoPassed402253 ms$0.0025
22 h agoPassed402161 ms$0.0025