Do I need an API key to access the HolidayExplore JSON API?

No API key or registration is required. All endpoints are hosted as pre-compiled static edge JSON files distributed globally via Cloudflare CDN for maximum speed (<20ms latency) and 99.99% uptime.

What are the rate limits for the free JSON API?

Because endpoints are statically cached at edge nodes, fair-use limits allow up to 120 requests per minute per IP address. Commercial automated pipelines (n8n, Make, Zapier, cron) are permitted under Creative Commons CC BY 4.0 with an attribution backlink.

What attribution is required to use this API?

Any website, app, or public dashboard utilizing HolidayExplore API data must include a visible text hyperlink back to https://holidayexplore.com/ or the specific country page (e.g. 'Data provided by HolidayExplore').

Which countries and years are covered by the API endpoints?

The API covers all 48 sovereign economies for calendar years 2026 and 2027, including statutory holiday dates, central bank RTGS cutoffs, weekend rest days, and live daily status feeds.

Authored by Sahin Choudhury • Verified: October 2026 • Open Static JSON Infrastructure

DEVELOPER INFRASTRUCTURE • OPEN DATA

Free Public Holiday & Central Bank Settlement API

Q: What are the rate limits for the free JSON API?

Because endpoints are statically cached at edge nodes, fair-use limits allow up to 120 requests per minute per IP address. Commercial automated pipelines (n8n, Make, Zapier, cron) are permitted under Creative Commons CC BY 4.0 with an attribution backlink.

Q: What attribution is required to use this API?

Any website, app, or public dashboard utilizing HolidayExplore API data must include a visible text hyperlink back to https://holidayexplore.com/ or the specific country page (e.g. 'Data provided by HolidayExplore').

Q: Which countries and years are covered by the API endpoints?

The API covers all 48 sovereign economies for calendar years 2026 and 2027, including statutory holiday dates, central bank RTGS cutoffs, weekend rest days, and live daily status feeds.

Ultra-low latency, zero-auth static JSON API serving statutory holidays, central bank RTGS operational cutoffs, and live daily banking status for 48 sovereign nations. Hosted globally on Cloudflare edge.

⚡ Enterprise Workplace Chronometry API Standard

Modern payroll, treasury, and international logistics workflows require deterministic holiday and banking status data without API key paywalls or rate limits. HolidayExplore provides immutable, edge-cached JSON feeds for 48 sovereign jurisdictions updated under statutory gazettes and central bank circulars.

Sovereign Economies

2026–2027

Verified Calendar Years

<20ms

Edge Cache Latency

Zero Auth

No API Key Required

🧪 Interactive Endpoint Sandbox

GET https://holidayexplore.com/api/v1/countries.json

Click "Fetch JSON" to inspect real-time edge response...

Endpoint Reference & Schemas

Endpoint URI	Output Data	Use Cases
GET /api/v1/countries.json	List of all 48 sovereign nations with ISO codes, currencies, timezones, RTGS names & cutoffs.	Populate country selector dropdowns, multi-country routing systems, and central bank lookup maps.
GET /api/v1/holidays/{country}.json	Full 2026–2027 statutory holiday array, weekend days, and central bank clearing status.	SLA deadline calculation, payroll T-2 engines, contract business day validation.
GET /api/v1/status/{country}/today.json	Real-time daily status: `is_bank_open`, `is_public_holiday`, next closure countdown.	n8n/Make/Zapier automated workflows, ops dashboard badges, and status widgets.

⚖️ Fair-Use Attribution Policy (CC BY 4.0)

HolidayExplore API endpoints are free for commercial and personal applications under Creative Commons Attribution 4.0. You must display a visible hyperlink back to https://holidayexplore.com/ (e.g. "Holiday & settlement data provided by HolidayExplore").

API Frequently Asked Questions

Is an API key or registration required to use the endpoints?

No. All endpoints under /api/v1/ are zero-authentication and publicly accessible. Standard caching headers (Cache-Control: public, max-age=3600) are set to ensure responses are delivered from Cloudflare edge caches worldwide.

What format is the holiday date returned in?

Dates are returned in ISO 8601 standard format (YYYY-MM-DD). In addition, each record specifies whether the day constitutes a sovereign statutory non-working day, a central bank clearing shutdown, or a regional market holiday.

Can we use this data for automated financial settlement systems?

Yes. Financial institutions and treasury systems use our payment rails matrix and daily status endpoints to verify whether central bank clearing mechanisms (such as Fedwire, TARGET2, and CHAPS) are operating before transmitting high-value settlement instructions.