{
"count": 250,
"countries": [
{
"country": "AD",
"subdivisions": [
"02",
"03",
"04"
]
},
{
"country": "AE",
"subdivisions": []
},
{
"country": "AF",
"subdivisions": []
}
]
}
curl --location --request GET 'https://zylalabs.com/api/15016/public+holidays+and+working+days+api/39648/list+supported+countries+and+their+subdivisions' --header 'Authorization: Bearer YOUR_API_KEY'
{
"country": "DE",
"from": "2026-11-17",
"holidays": [
{
"date": "2026-12-25",
"name": "Erster Weihnachtstag",
"weekday": "Friday",
"days_away": 38
},
{
"date": "2026-12-26",
"name": "Zweiter Weihnachtstag",
"weekday": "Saturday",
"days_away": 39
},
{
"date": "2027-01-01",
"name": "Neujahr",
"weekday": "Friday",
"days_away": 45
}
]
}
curl --location --request GET 'https://zylalabs.com/api/15016/public+holidays+and+working+days+api/39649/upcoming+public+holidays?limit=5&country=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"country": "GB",
"date": "2027-12-25",
"weekday": "Saturday",
"is_holiday": true,
"holiday_name": "Christmas Day",
"is_weekend": true,
"is_business_day": false
}
curl --location --request GET 'https://zylalabs.com/api/15016/public+holidays+and+working+days+api/39650/check+if+a+date+is+a+holiday+or+business+day?date=2027-12-25&country=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"country": "US",
"start": "2027-01-04",
"end": "2027-01-29",
"calendar_days": 26,
"business_days": 19,
"holidays_on_weekdays": [
{
"date": "2027-01-18",
"name": "Martin Luther King Jr. Day"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/15016/public+holidays+and+working+days+api/39651/count+or+add+business+days?start=2027-01-04&end=2027-01-29&country=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"country": "US",
"subdivision": null,
"year": 2027,
"count": 15,
"holidays": [
{
"date": "2027-01-01",
"name": "New Year's Day",
"weekday": "Friday"
},
{
"date": "2027-01-18",
"name": "Martin Luther King Jr. Day",
"weekday": "Monday"
},
{
"date": "2027-02-15",
"name": "Washington's Birthday",
"weekday": "Monday"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/15016/public+holidays+and+working+days+api/39652/list+public+holidays+for+a+country+and+year&country=Required&/=Required&year=Required' --header 'Authorization: Bearer YOUR_API_KEY'
After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Public Holidays and Working Days API simply include your bearer token in the Authorization header.
| Header | Description |
|---|---|
Authorization
|
Required
Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.
|
No long-term commitment. Upgrade, downgrade, or cancel anytime.
Public holidays for 150+ countries, with next holiday, is-it-a-holiday checks and working-day calculations.
The open-source holidays library, computed locally.
Public holidays only. Verify before relying on them for payroll or legal deadlines. Weekends follow each country's convention.
Each endpoint returns JSON data related to public holidays and working days. For example, the "Upcoming public holidays" endpoint provides holiday dates, names, weekdays, and days away, while the "Check if a date is a holiday" endpoint indicates if a specific date is a holiday or business day.
Key fields include "country," "date," "name," "weekday," "is_holiday," and "is_business_day." For example, the "List public holidays" endpoint includes "count" and an array of holiday objects with their respective details.
Parameters vary by endpoint. For "List public holidays," you can specify "country" and "year." The "Count or add business days" endpoint accepts "start," "end," or "add" parameters to customize the request based on your needs.
Response data is structured in JSON format, typically containing a main object with fields like "country" and "holidays." Each holiday is represented as an object within an array, detailing its date, name, and weekday.
The API provides information on upcoming holidays, checks for specific dates, lists holidays by country and year, and calculates business days. Each endpoint serves distinct purposes, allowing users to access comprehensive holiday data.
Users can parse the JSON response to extract relevant information, such as upcoming holidays or whether a specific date is a holiday. This data can be integrated into applications for scheduling, planning, or compliance purposes.
Typical use cases include planning events around holidays, managing employee schedules, and ensuring compliance with local holiday regulations. Businesses can use the API to automate holiday checks and working day calculations.
Data accuracy is maintained through the use of an open-source holidays library, which is regularly updated and computed locally. Users are encouraged to verify the data for critical applications, such as payroll or legal deadlines.
To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund