Japan has 16+ national holidays plus substitute holidays (振替休日) and sandwich holidays (国民の休日). Torify provides accurate holiday detection including 2027+ projections.
https://torify.dev/v1/holiday/check
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
date |
string | Yes | YYYY-MM-DD | 2024-01-01 |
year |
integer | No | Year — returns full annual list | 2024 |
{ "ok": true, "data": { "date": "2024-01-01", "isHoliday": true, "name": "元日", "type": "national" } }curl "https://torify.dev/v1/holiday/check?date=2024-01-01"import { wrapFetchWithPayment } from 'x402-fetch';
import { privateKeyToAccount } from 'viem/accounts';
const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const fetchWithPayment = wrapFetchWithPayment(fetch, account);
const res = await fetchWithPayment(
'https://torify.dev/v1/holiday/check?date=2024-01-01'
);
const data = await res.json();
console.log(data); // { ok: true, data: { ... } }import requests
# Free MCP tier (no auth) or API key (X-API-Key header)
res = requests.get(
"https://torify.dev/v1/holiday/check?date=2024-01-01",
headers={"X-API-Key": "your_torify_pro_key"}
)
print(res.json())/v1/wareki/convert — Wareki Conversion: Japanese Era Date API
/v1/legal-holiday/check — Japan Statutory Rest Day API: Labor Standards Act Art. 35
/v1/age/calculate — Japan Age & School Year Calculation API