H

Holiday Calendar API · Next

by Holiday Calendar API

GETBaseArbitrumPolygon

$0.005

per call · USD Coin on Base

Next official public holiday after a date for a supported country or regional subdivision.

Endpoint

GET https://holidays.use.x402atlas.com/next

4

Calls / 30d

3

Unique payers / 30d

Sep 1

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/next", {
  method: "GET",
});
const data = await res.json();
cURL
curl -X GET \
  "https://holidays.use.x402atlas.com/next?after=2026-02-01&country=DE&language=EN&subdivision=DE-BE" \
  -H "X-PAYMENT: <signed x402 payment>"

Example response

{
  "after": "2026-02-01",
  "country": "DE",
  "holiday": {
    "end_date": "2026-03-08",
    "name": "International Women's Day",
    "nationwide": false,
    "regional_scope": "Regional",
    "start_date": "2026-03-08",
    "subdivisions": [
      "DE-BE"
    ],
    "temporal_scope": "FullDay",
    "type": "Public"
  },
  "language": "EN",
  "queried_at": "2026-07-27T12:00:00Z",
  "subdivision": "DE-BE"
}

Payment details

Pay to0x8c128f1ee62bb5e47867cfbae2ad89be325df1b2
AssetUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
NetworksBase, Arbitrum, Polygon
Schemesexact

Is this your API?

Pin it to the top of Developer Tools and the homepage with a featured placement.

Get featured →

More from Holiday Calendar API & similar services