Calendar Holidays
by 2s in Productivity & SaaS
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
- 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
| When | Result | HTTP | Time | Price |
|---|---|---|---|---|
| 3 h ago | Passed | 402 | 302 ms | $0.0025 |
| 6 h ago | Passed | 402 | 156 ms | $0.0025 |
| 10 h ago | Passed | 402 | 154 ms | $0.0025 |
| 14 h ago | Passed | 402 | 538 ms | $0.0025 |
| 17 h ago | Passed | 402 | 253 ms | $0.0025 |
| 22 h ago | Passed | 402 | 161 ms | $0.0025 |