by Test
Check public holidays for any country and date. Covers 200+ countries with holiday names, types, and local observances. Powered by Abstract API.
/?country={country}&year={year}&month={month}&day={day}| Name | Type | Required | Description | Example |
|---|---|---|---|---|
country | string | required | 2-letter country code | US |
year | integer | required | Year | 2026 |
month | integer | optional | Month | 12 |
day | integer | optional | Day | 25 |
[
{
"date": "12/25/2026",
"name": "Christmas Day",
"type": "National",
"country": "US"
}
]Bad Request
Missing or invalid parameters
Unauthorized
Invalid or missing API credentials
Too Many Requests
Rate limit exceeded
Internal Server Error
Upstream API error — payment hash released for retry
All calls use the x402 payment protocol: send a request, receive a 402 with payment instructions, send USDC on Base L2, then re-call with the transaction hash.
GET https://gateflow-proxy.7crypto-jo.workers.dev/v1/a072c723/holiday-calendar — receive a 402 with payment instructions
Send USDC on Base L2 to the address in X-Payment-Address
Wait for 1+ block confirmation (≈ 2 seconds on Base)
Re-send your original request with the tx hash in X-Payment-Hash
Obolo verifies on-chain and proxies the request to the upstream API
AP2 Support
This endpoint also accepts AP2 Cart Mandates. Include a signed Cart Mandate in the X-AP2-Mandate header with an x402 tx hash embedded in payment.txHash.
curl "https://gateflow-proxy.7crypto-jo.workers.dev/v1/a072c723/holiday-calendar" \
-H "X-Payment-Hash: 0x<your_tx_hash>" \
-H "X-Payment-Chain: 8453"https://gateflow-proxy.7crypto-jo.workers.dev/v1/a072c723/holiday-calendarUSDC
Base L2 (Chain 8453)
Protocols