National Holidays API
Tallyfy maintains a dataset of national holidays to help us auto-shift deadlines within our workflow tool based on known public holidays. We also make this data available free to anyone.
API Documentation
List All Countries
GET /national-holidays/api/index.json
Returns a list of all countries with available holiday data.
Country Overview
GET /national-holidays/api/{country}/index.json
Returns available years and endpoints for a specific country. Use ISO 3166-1 alpha-2 codes (US, GB, DE, etc.).
Holidays by Year
GET /national-holidays/api/{country}/{year}.json
Returns all holidays for a specific country and year. Example: /national-holidays/api/US/2026.json
Response Format
{
"country": {
"code": "US",
"code3": "USA",
"name": "United States"
},
"year": 2026,
"holidays": [
{
"date": "2026-01-01",
"name": "New Year's Day",
"local_name": "New Year's Day",
"type": "national",
"observed_date": "2026-01-01",
"is_observed_shifted": false,
"description": "First day of the new year"
}
],
"metadata": {
"generated_at": "2026-01-15T00:00:00Z",
"total_holidays": 11,
"disclaimer": "..."
}
}Browse Countries
A
B
C
D
E
G
I
K
L
M
N
P
S
T
U
Use Cases
Business Day Calculations
Calculate deadlines and delivery dates by excluding weekends and national holidays.
Scheduling Applications
Show holidays in calendars and scheduling interfaces for better planning.
HR Systems
Track national holidays for leave management and payroll calculations.
Financial Applications
Determine market closures and settlement dates based on bank holidays.
This data is provided for informational purposes only. While we strive for accuracy, holiday dates and observance rules can change. Please verify critical dates with official government sources. Tallyfy accepts no liability for any errors or decisions made based on this data.