{countryCode}: Check if today is a public holiday

API: nager.at:holidays
Endpoint: /api/v3/IsTodayPublicHoliday/{countryCode}
Response format: unknown
Auth: unknown
Method: GET
Last Status: 204
Latency: 142ms

Description

Returns HTTP 200 if today is a public holiday, 204 if not. Supports timezone offset adjustment.

Parameters (3)

countryCode (string, path, required)

ISO 3166-1 alpha-2 country code (e.g., US, DE, FR)

countyCode (string, query, optional)

ISO-3166-2 county code for state/province-specific check

offset (integer, query, optional, default: 0)

UTC timezone offset (hours from -12 to 12)

Constraints: {'minimum': -12, 'maximum': 12}

Examples (1)

Check if today is a public holiday openapi-spec
curl 'https://date.nager.at/api/v3/IsTodayPublicHoliday/US'
import requests

resp = requests.get("https://date.nager.at/api/v3/IsTodayPublicHoliday/US")
data = resp.json()
import zingu_apis

api = zingu_apis.api("nager")
result = api.fetch("api/v3/IsTodayPublicHoliday/{countryCode}")

for item in result:
    print(item)
const resp = await fetch("https://date.nager.at/api/v3/IsTodayPublicHoliday/US");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 17:31:49.142619 204 142ms
2026-04-16 02:13:33.145719 204 163ms
2026-04-15 02:59:21.994129 204 188ms
2026-04-14 03:21:01.612433 204 164ms
2026-04-12 13:29:53.612199 204 124ms
2026-04-10 02:54:40.963229 204 175ms
2026-04-09 00:26:50.009284 204 195ms