← World Data

Check Holiday

GET /holidays/check

Check whether a specific date is a public holiday in a given country. Returns holiday name and details if the date is a holiday, or confirms it is not. Supports 100+ countries. Ideal for payroll systems that need to account for public holidays, scheduling apps that should block holiday dates, and business tools that adjust deadlines around non-working days.

Parameters

country required

Country code

date required

Date

Example Requests

Basic usage
curl "https://nordapi.ee/api/v1/holidays/check?country=US&date=2026-12-25"
Check if Christmas is a US holiday
curl "https://nordapi.ee/api/v1/holidays/check?country=US&date=2026-12-25"
Check Norwegian Constitution Day
curl "https://nordapi.ee/api/v1/holidays/check?country=NO&date=2026-05-17"
Check a regular weekday in Germany
curl "https://nordapi.ee/api/v1/holidays/check?country=DE&date=2026-03-25"

Live Response 

{
  "country_code": "US",
  "date": "2026-12-25",
  "is_holiday": true,
  "success": true
}
← Back to World Data