Look up public holidays for 55 countries, calculate business day deadlines, find the next business day, export holidays to iCal, and more — all backed by versioned JSON data with no external dependencies at runtime. Covers 55 countries across Africa, Americas, Asia, Europe and Oceania for years 2024 to 2027.
{"success":true,"data":[{"code":"AD","name":"Andorra","supported":true},{"code":"AR","name":"Argentina","supported":true},{"code":"AU","name":"Australia","supported":true},{"code":"AT","name":"Austria","supported":true},{"code":"BE","name":"Belgium","supported":true},{"code":"BR","name":"Brazil","supported":true},{"code":"CA","name":"Canada","supported":true},{"code":"CL","name":"Chile","supported":true},{"code":"CN","name":"China","supported":true},{"code":"CO","name":"Colombia","supported":true},{"code":"HR","name":"Croatia","supported":true},{"code":"CZ","name":"Czech Republic","supported":true},{"code":"DK","name":"Denmark","supported":true},{"code":"EG","name":"Egypt","supported":true},{"code":"FI","name":"Finland","supported":true},{"code":"FR","name":"France","supported":true},{"code":"DE","name":"Germany","supported":true},{"code":"GR","name":"Greece","supported":true},{"code":"HU","name":"Hungary","supported":true},{"code":"HK","name":"Hong Kong","supported":true},{"code":"ID","name":"Indonesia","supported":true},{"code":"IE","name":"Ireland","supported":true},{"code":"IT","name":"Italy","supported":true},{"code":"JP","name":"Japan","supported":true},{"code":"KE","name":"Kenya","supported":true},{"code":"LU","name":"Luxembourg","supported":true},{"code":"SK","name":"Slovakia","supported":true},{"code":"MX","name":"Mexico","supported":true},{"code":"MA","name":"Morocco","supported":true},{"code":"NL","name":"Netherlands","supported":true},{"code":"NZ","name":"New Zealand","supported":true},{"code":"NG","name":"Nigeria","supported":true},{"code":"NO","name":"Norway","supported":true},{"code":"CY","name":"Cyprus","supported":true},{"code":"PE","name":"Peru","supported":true},{"code":"PH","name":"Philippines","supported":true},{"code":"PL","name":"Poland","supported":true},{"code":"PT","name":"Portugal","supported":true},{"code":"RO","name":"Romania","supported":true},{"code":"RU","name":"Russia","supported":true},{"code":"UA","name":"Ukraine","supported":true},{"code":"SG","name":"Singapore","supported":true},{"code":"VN","name":"Vietnam","supported":true},{"code":"ZA","name":"South Africa","supported":true},{"code":"KR","name":"South Korea","supported":true},{"code":"ES","name":"Spain","supported":true},{"code":"SE","name":"Sweden","supported":true},{"code":"CH","name":"Switzerland","supported":true},{"code":"GB","name":"United Kingdom","supported":true},{"code":"US","name":"United States","supported":true},{"code":"IN","name":"India","supported":true},{"code":"IL","name":"Israel","supported":true},{"code":"MY","name":"Malaysia","supported":true},{"code":"PK","name":"Pakistan","supported":true},{"code":"SA","name":"Saudi Arabia","supported":true}],"meta":{"count":55}}
curl --location --request GET 'https://zylalabs.com/api/12760/global+holidays+and+business+days+api/24841/list+supported+countries' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":[{"date":"2026-01-01","localName":"New Year's Day","name":"New Year's Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-03-21","localName":"Human Rights Day","name":"Human Rights Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-04-03","localName":"Good Friday","name":"Good Friday","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-04-06","localName":"Family Day","name":"Family Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-04-27","localName":"Freedom Day","name":"Freedom Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-05-01","localName":"Workers' Day","name":"Workers' Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-06-16","localName":"Youth Day","name":"Youth Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-08-10","localName":"National Women's Day","name":"National Women's Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-09-24","localName":"Heritage Day","name":"Heritage Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-12-16","localName":"Day of Reconciliation","name":"Day of Reconciliation","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-12-25","localName":"Christmas Day","name":"Christmas Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-12-26","localName":"St. Stephen's Day","name":"Day of Goodwill","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]}],"meta":{"country":"ZA","year":2026,"count":12}}
curl --location --request GET 'https://zylalabs.com/api/12760/global+holidays+and+business+days+api/24842/get+holidays+by+year&country=Required&/=Required&year=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":[{"date":"2026-12-16","localName":"Day of Reconciliation","name":"Day of Reconciliation","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-12-25","localName":"Christmas Day","name":"Christmas Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-12-26","localName":"St. Stephen's Day","name":"Day of Goodwill","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]}],"meta":{"country":"ZA","year":2026,"month":12,"count":3}}
curl --location --request GET 'https://zylalabs.com/api/12760/global+holidays+and+business+days+api/24843/get+holidays+by+month&country=Required&/=Required&year=Required&/=Required&month=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":[{"month":1,"name":"January","count":1},{"month":2,"name":"February","count":0},{"month":3,"name":"March","count":1},{"month":4,"name":"April","count":3},{"month":5,"name":"May","count":1},{"month":6,"name":"June","count":1},{"month":7,"name":"July","count":0},{"month":8,"name":"August","count":1},{"month":9,"name":"September","count":1},{"month":10,"name":"October","count":0},{"month":11,"name":"November","count":0},{"month":12,"name":"December","count":3}],"meta":{"country":"ZA","year":2026,"total":12}}
curl --location --request GET 'https://zylalabs.com/api/12760/global+holidays+and+business+days+api/24844/get+holiday+summary+by+month&country=Required&/=Required&year=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":[],"meta":{"country":"ZA","from":"2026-06-22","to":"2026-07-22","days_window":30,"count":0}}
curl --location --request GET 'https://zylalabs.com/api/12760/global+holidays+and+business+days+api/24845/get+upcoming+holidays&country=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":[{"date":"2026-01-01","localName":"New Year's Day","name":"New Year's Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-03-21","localName":"Human Rights Day","name":"Human Rights Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-04-03","localName":"Good Friday","name":"Good Friday","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-04-06","localName":"Family Day","name":"Family Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-04-27","localName":"Freedom Day","name":"Freedom Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]}],"meta":{"country":"ZA","year":2026,"from":"2026-01-01","to":"2026-04-30","count":5}}
curl --location --request GET 'https://zylalabs.com/api/12760/global+holidays+and+business+days+api/24846/get+holidays+by+date+range&country=Required&/=Required&year=Required&/=Required&from=Required&/=Required&to=Required' --header 'Authorization: Bearer YOUR_API_KEY'
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//sebbo.net//ical-generator//EN
NAME:ZA Public Holidays 2026
X-WR-CALNAME:ZA Public Holidays 2026
BEGIN:VEVENT
UID:383d700d-ed90-4c90-9d1a-f5561a22a9e1
SEQUENCE:0
DTSTAMP:20260622T155815Z
DTSTART;VALUE=DATE:20260101
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:New Year's Day
END:VEVENT
BEGIN:VEVENT
UID:90225314-c30e-40ef-a688-2c62d3d09ed2
SEQUENCE:0
DTSTAMP:20260622T155815Z
DTSTART;VALUE=DATE:20260321
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Human Rights Day
END:VEVENT
BEGIN:VEVENT
UID:f3ed1d6b-cdc1-45da-8301-c36466b11619
SEQUENCE:0
DTSTAMP:20260622T155815Z
DTSTART;VALUE=DATE:20260403
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Good Friday
END:VEVENT
BEGIN:VEVENT
UID:198e2a30-90fa-4618-9136-33b7ddc23481
SEQUENCE:0
DTSTAMP:20260622T155815Z
DTSTART;VALUE=DATE:20260406
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Family Day
END:VEVENT
BEGIN:VEVENT
UID:25124a20-9f1f-4dcd-a371-ae5e1d8fefe9
SEQUENCE:0
DTSTAMP:20260622T155815Z
DTSTART;VALUE=DATE:20260427
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Freedom Day
END:VEVENT
BEGIN:VEVENT
UID:56e65b8f-26e8-4d43-ae06-5449f3c2f77f
SEQUENCE:0
DTSTAMP:20260622T155815Z
DTSTART;VALUE=DATE:20260501
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Workers' Day
END:VEVENT
BEGIN:VEVENT
UID:a34dc671-dc66-4372-8a1f-f33d8a0d3041
SEQUENCE:0
DTSTAMP:20260622T155815Z
DTSTART;VALUE=DATE:20260616
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Youth Day
END:VEVENT
BEGIN:VEVENT
UID:12dba5f4-cf40-47e8-a0e2-ee4395639c4c
SEQUENCE:0
DTSTAMP:20260622T155815Z
DTSTART;VALUE=DATE:20260810
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:National Women's Day
END:VEVENT
BEGIN:VEVENT
UID:f841d110-4163-4366-aca2-a944f19d3cab
SEQUENCE:0
DTSTAMP:20260622T155815Z
DTSTART;VALUE=DATE:20260924
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Heritage Day
END:VEVENT
BEGIN:VEVENT
UID:74c797d0-6086-435d-94f0-838772be1ba8
SEQUENCE:0
DTSTAMP:20260622T155815Z
DTSTART;VALUE=DATE:20261216
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Day of Reconciliation
END:VEVENT
BEGIN:VEVENT
UID:52665438-64aa-40fa-aaac-4bde58e7899d
SEQUENCE:0
DTSTAMP:20260622T155815Z
DTSTART;VALUE=DATE:20261225
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Christmas Day
END:VEVENT
BEGIN:VEVENT
UID:c650d3dd-e456-4519-be08-92b279b0bd9d
SEQUENCE:0
DTSTAMP:20260622T155815Z
DTSTART;VALUE=DATE:20261226
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Day of Goodwill
END:VEVENT
END:VCALENDAR
curl --location --request GET 'https://zylalabs.com/api/12760/global+holidays+and+business+days+api/24847/export+holidays+to+ical&country=Required&/=Required&year=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"ZA":[{"date":"2026-01-01","localName":"New Year's Day","name":"New Year's Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-03-21","localName":"Human Rights Day","name":"Human Rights Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-04-03","localName":"Good Friday","name":"Good Friday","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-04-06","localName":"Family Day","name":"Family Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-04-27","localName":"Freedom Day","name":"Freedom Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-05-01","localName":"Workers' Day","name":"Workers' Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-06-16","localName":"Youth Day","name":"Youth Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-08-10","localName":"National Women's Day","name":"National Women's Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-09-24","localName":"Heritage Day","name":"Heritage Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-12-16","localName":"Day of Reconciliation","name":"Day of Reconciliation","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-12-25","localName":"Christmas Day","name":"Christmas Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-12-26","localName":"St. Stephen's Day","name":"Day of Goodwill","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]}],"US":[{"date":"2026-01-01","localName":"New Year's Day","name":"New Year's Day","countryCode":"US","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public","Bank"]},{"date":"2026-01-19","localName":"Martin Luther King, Jr. Day","name":"Martin Luther King, Jr. Day","countryCode":"US","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public","Bank"]},{"date":"2026-02-12","localName":"Lincoln's Birthday","name":"Lincoln's Birthday","countryCode":"US","fixed":false,"global":false,"counties":["US-CA","US-CT","US-IL","US-IN","US-KY","US-MI","US-NY","US-MO","US-OH"],"launchYear":null,"types":["Observance"]},{"date":"2026-02-16","localName":"Washington's Birthday","name":"Presidents Day","countryCode":"US","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public","Bank"]},{"date":"2026-04-03","localName":"Good Friday","name":"Good Friday","countryCode":"US","fixed":false,"global":false,"counties":["US-CT","US-DE","US-HI","US-IN","US-KY","US-LA","US-NC","US-ND","US-NJ","US-TN"],"launchYear":null,"types":["Public"]},{"date":"2026-04-03","localName":"Good Friday","name":"Good Friday","countryCode":"US","fixed":false,"global":false,"counties":["US-TX"],"launchYear":null,"types":["Optional"]},{"date":"2026-05-08","localName":"Truman Day","name":"Truman Day","countryCode":"US","fixed":false,"global":false,"counties":["US-MO"],"launchYear":null,"types":["School","Authorities"]},{"date":"2026-05-25","localName":"Memorial Day","name":"Memorial Day","countryCode":"US","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public","Bank"]},{"date":"2026-06-19","localName":"Juneteenth National Independence Day","name":"Juneteenth National Independence Day","countryCode":"US","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public","Bank"]},{"date":"2026-07-03","localName":"Independence Day","name":"Independence Day","countryCode":"US","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public","Bank"]},{"date":"2026-09-07","localName":"Labor Day","name":"Labour Day","countryCode":"US","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public","Bank"]},{"date":"2026-10-12","localName":"Columbus Day","name":"Columbus Day","countryCode":"US","fixed":false,"global":false,"counties":["US-AL","US-AZ","US-CO","US-CT","US-GA","US-ID","US-IL","US-IN","US-IA","US-KS","US-KY","US-LA","US-ME","US-MD","US-MA","US-MS","US-MO","US-MT","US-NE","US-NH","US-NJ","US-NM","US-NY","US-NC","US-OH","US-OK","US-PA","US-RI","US-SC","US-TN","US-UT","US-VA","US-WV"],"launchYear":null,"types":["Public"]},{"date":"2026-10-12","localName":"Columbus Day","name":"Columbus Day","countryCode":"US","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Bank"]},{"date":"2026-10-12","localName":"Indigenous Peoples' Day","name":"Indigenous Peoples' Day","countryCode":"US","fixed":false,"global":false,"counties":["US-AK","US-AL","US-CA","US-HI","US-IA","US-LA","US-ME","US-MI","US-MN","US-NC","US-NE","US-NM","US-OK","US-OR","US-SD","US-TX","US-VA","US-VT","US-WI"],"launchYear":null,"types":["Public"]},{"date":"2026-11-11","localName":"Veterans Day","name":"Veterans Day","countryCode":"US","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public","Bank"]},{"date":"2026-11-26","localName":"Thanksgiving Day","name":"Thanksgiving Day","countryCode":"US","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public","Bank"]},{"date":"2026-12-25","localName":"Christmas Day","name":"Christmas Day","countryCode":"US","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public","Bank"]}],"GB":[{"date":"2026-01-01","localName":"New Year's Day","name":"New Year's Day","countryCode":"GB","fixed":false,"global":false,"counties":["GB-ENG","GB-NIR","GB-SCT","GB-WLS"],"launchYear":null,"types":["Public"]},{"date":"2026-01-02","localName":"2 January","name":"2 January","countryCode":"GB","fixed":false,"global":false,"counties":["GB-SCT"],"launchYear":null,"types":["Public"]},{"date":"2026-03-17","localName":"Saint Patrick's Day","name":"Saint Patrick's Day","countryCode":"GB","fixed":false,"global":false,"counties":["GB-NIR"],"launchYear":null,"types":["Public"]},{"date":"2026-04-03","localName":"Good Friday","name":"Good Friday","countryCode":"GB","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-04-06","localName":"Easter Monday","name":"Easter Monday","countryCode":"GB","fixed":false,"global":false,"counties":["GB-ENG","GB-WLS","GB-NIR"],"launchYear":null,"types":["Public"]},{"date":"2026-05-04","localName":"Early May Bank Holiday","name":"Early May Bank Holiday","countryCode":"GB","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-05-25","localName":"Spring Bank Holiday","name":"Spring Bank Holiday","countryCode":"GB","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-06-15","localName":"World Cup Bank Holiday","name":"World Cup Bank Holiday","countryCode":"GB","fixed":false,"global":false,"counties":["GB-SCT"],"launchYear":null,"types":["Public"]},{"date":"2026-07-13","localName":"Battle of the Boyne","name":"Battle of the Boyne","countryCode":"GB","fixed":false,"global":false,"counties":["GB-NIR"],"launchYear":null,"types":["Public"]},{"date":"2026-08-03","localName":"Summer Bank Holiday","name":"Summer Bank Holiday","countryCode":"GB","fixed":false,"global":false,"counties":["GB-SCT"],"launchYear":null,"types":["Public"]},{"date":"2026-08-31","localName":"Summer Bank Holiday","name":"Summer Bank Holiday","countryCode":"GB","fixed":false,"global":false,"counties":["GB-ENG","GB-WLS","GB-NIR"],"launchYear":null,"types":["Public"]},{"date":"2026-11-30","localName":"Saint Andrew's Day","name":"Saint Andrew's Day","countryCode":"GB","fixed":false,"global":false,"counties":["GB-SCT"],"launchYear":null,"types":["Public"]},{"date":"2026-12-25","localName":"Christmas Day","name":"Christmas Day","countryCode":"GB","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2026-12-28","localName":"Boxing Day","name":"St. Stephen's Day","countryCode":"GB","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]}]},"meta":{"year":2026,"countries_requested":3,"countries_returned":3,"missing":[]}}
curl --location --request POST 'https://zylalabs.com/api/12760/global+holidays+and+business+days+api/24848/bulk+holiday+lookup' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"countries": ["ZA", "US", "GB"],
"year": 2026
}'
{"success":true,"data":{"businessDays":21,"calendarDays":30,"startDate":"2026-01-01","endDate":"2026-01-31"},"meta":{"country":"ZA"}}
curl --location --request POST 'https://zylalabs.com/api/12760/global+holidays+and+business+days+api/24849/count+business+days' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"country": "ZA",
"startDate": "2026-01-01",
"endDate": "2026-01-31"
}'
{"success":true,"data":{"startDate":"2026-01-01","days":5,"resultDate":"2026-01-08"},"meta":{"country":"ZA"}}
curl --location --request POST 'https://zylalabs.com/api/12760/global+holidays+and+business+days+api/24850/add+business+days' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"country": "ZA",
"startDate": "2026-01-01",
"days": 5
}'
{"success":true,"data":{"startDate":"2026-01-31","days":5,"resultDate":"2026-01-26"},"meta":{"country":"ZA"}}
curl --location --request POST 'https://zylalabs.com/api/12760/global+holidays+and+business+days+api/24851/subtract+business+days' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"country": "ZA",
"startDate": "2026-01-31",
"days": 5
}'
{"success":true,"data":{"date":"2026-04-03","isBusinessDay":false,"dayOfWeek":"Friday","country":"ZA"},"meta":{"country":"ZA"}}
curl --location --request POST 'https://zylalabs.com/api/12760/global+holidays+and+business+days+api/24852/check+business+day' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"country": "ZA",
"date": "2026-04-03"
}'
{"success":true,"data":{"fromDate":"2026-01-01","nextBusinessDay":"2026-01-02","daysSkipped":0},"meta":{"country":"ZA"}}
curl --location --request POST 'https://zylalabs.com/api/12760/global+holidays+and+business+days+api/24853/get+next+business+day' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"country": "ZA",
"date": "2026-01-01"
}'
{"success":true,"data":{"startDate":"2026-01-01","slaDays":10,"deadlineDate":"2026-01-15","deadlineIsHoliday":false,"deadlineIsWeekend":false,"mode":"business","country":"ZA"},"meta":{"country":"ZA"}}
curl --location --request POST 'https://zylalabs.com/api/12760/global+holidays+and+business+days+api/24854/calculate+business+day+deadline' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"country": "ZA",
"startDate": "2026-01-01",
"slaDays": 10,
"mode": "business"
}'
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 Global Holidays and Business 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. Free Trial includes up to 50 requests.
(Save 2 months with annual billing 🎉)
Look up public holidays for 55 countries, calculate business day deadlines, find the next business day, export holidays to iCal, and more — all backed by versioned JSON data with no external dependencies at runtime. Covers 55 countries across Africa, Americas, Asia, Europe and Oceania for years 2024 to 2027.
The API covers 55 countries across Africa, Americas, Asia, Europe, and Oceania. Use the GET /countries endpoint to retrieve the full list with ISO codes.
Holiday data is available for 2024, 2025, 2026, and 2027. Data is refreshed automatically each January to add the new year.
Business mode counts only working days, skipping weekends and public holidays. Calendar mode counts raw calendar days from the start date and flags if the result lands on a holiday or weekend.
Yes — use the Export Holidays to iCal endpoint to download a .ics file compatible with Google Calendar, Apple Calendar, Outlook, and any application that supports the iCal format.
The Bulk Holiday Lookup endpoint lets you fetch holidays for up to 10 countries in a single request, ideal for multi-country HR, payroll, and logistics platforms.
Business days exclude Saturdays, Sundays, and country-specific public holidays. The count follows the standard financial convention — includes the start date, excludes the end date.
Yes — holiday data is refreshed automatically every January via an automated pipeline. No changes are required from API consumers.
This endpoint returns a list of public holidays for a specified country and year, including details such as the holiday date, local name, and holiday type. Each holiday entry includes fields like "date," "localName," "name," "countryCode," and "types."
Users can customize requests by specifying the country code, year, and month number (1-12). An optional "type" parameter allows filtering by holiday type, such as Public, Bank, Optional, or Observance.
The response includes fields such as "date," "localName," "name," "countryCode," and "types." Additionally, metadata like "from," "to," and "days_window" provides context for the holiday timeframe.
This endpoint provides a breakdown of public holiday counts for each month of a specified year in a given country. It returns all 12 months, including months with zero holidays, along with the count of holidays for each month.
The response is structured as a JSON object containing a "success" field and a "data" field. The "data" field is an object where each key is a country code, and the value is an array of holiday objects for that country.
This endpoint is useful for calculating deadlines, project timelines, or payment processing schedules by determining the number of business days between two dates while excluding weekends and public holidays.
Users can check if a specific date is a business day, which helps in scheduling meetings, setting deadlines, or planning events. The response indicates whether the date is a business day and provides the day of the week for reference.
The API's holiday data is refreshed annually through an automated pipeline, ensuring that it reflects the most current public holiday information. This process helps maintain high data quality and accuracy across all supported countries.
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