H
$0.005
per call · USD Coin on Base
Holiday date check by country or subdivision — determine whether one ISO date is an official public holiday.
Endpoint
GET https://holidays.use.x402atlas.com/check11
Calls / 30d
7
Unique payers / 30d
Sep 8
Last called
exact
Payment scheme
Call this service
TypeScript · @x402/fetch
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";
const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);
const res = await fetchWithPay("https://holidays.use.x402atlas.com/check", {
method: "GET",
});
const data = await res.json();cURL
curl -X GET \
"https://holidays.use.x402atlas.com/check?country=DE&date=2026-01-01&language=EN&subdivision=DE-BE" \
-H "X-PAYMENT: <signed x402 payment>"Example response
{
"country": "DE",
"date": "2026-01-01",
"holidays": [
{
"end_date": "2026-01-01",
"name": "New Year's Day",
"nationwide": true,
"regional_scope": "National",
"start_date": "2026-01-01",
"subdivisions": [],
"temporal_scope": "FullDay",
"type": "Public"
}
],
"is_holiday": true,
"language": "EN",
"queried_at": "2026-07-27T12:00:00Z",
"subdivision": "DE-BE"
}Payment details
Pay to
0x8c128f1ee62bb5e47867cfbae2ad89be325df1b2Asset
USD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913NetworksBase, Arbitrum, Polygon
Schemesexact
Is this your API?
Pin it to the top of Developer Tools and the homepage with a featured placement.
More from Holiday Calendar API & similar services
H
Holiday Calendar API · ADD Business Days
holidays.use.x402atlas.com
Add business days while skipping weekends and full-day Public or Bank holidays; Optional and HalfDay observances are retained.
GETBaseDeveloper Tools
$0.005 / call11 calls / 30d
H
Holiday Calendar API · Next
holidays.use.x402atlas.com
Next official public holiday after a date for a supported country or regional subdivision.
GETBaseDeveloper Tools
$0.005 / call4 calls / 30d
H
Holiday Calendar API · List
holidays.use.x402atlas.com
Official public holidays by country and year, with regional subdivisions, localized names and normalized dates.
GETBaseDeveloper Tools
$0.005 / call4 calls / 30d