Global Public & Bank Holiday
# Global Bank & Public Holiday API ## ⚡ Get Your First Response in 2 Minutes **Step 1:** Subscribe to the Free plan and copy your API key. **Step 2:** Run this request: ``` GET /v1/holidays?country_code=US&year=2025 ``` **Step 3:** You'll get back: ```json { "country": "US", "subdivision": null, "year": 2025, "total": 11, "holidays": [ { "date": "2025-01-01", "name": "New Year's Day" }, {…
Global Public & Bank Holiday endpoints
| Method | Endpoint | Description |
|---|---|---|
| Holidays | ||
| GET |
GetHolidays /v1/holidays |
Returns all public holidays for the given country and year. Optionally filter to a specific state, province, or region by passing the subdiv query parameter alongside the country… |
| Countries | ||
| GET |
ListSupportedCountries /v1/countries |
Returns all countries supported by this API, each with its ISO 3166-1 alpha-2 code and available subdivision codes. Use these values in GET /holidays to query holidays for a… |
| Health | ||
| GET |
HealthCheck /v1/health |
Returns the current health status of the API. Use this endpoint to confirm the service is up and reachable before making requests. No authentication required. Responds with… |
Global Public & Bank Holiday pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $3.99 / month | — |
|
| ULTRA Recommended | $13.99 / month | — |
|
| MEGA | $44.99 / month | — |
|