{"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/12764/sla+deadline+calculator+global+holidays+api/24903/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/12764/sla+deadline+calculator+global+holidays+api/24904/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/12764/sla+deadline+calculator+global+holidays+api/24905/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/12764/sla+deadline+calculator+global+holidays+api/24906/get+holiday+summary+by+month&country=Required&/=Required&year=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":[{"date":"2026-06-16","localName":"Youth Day","name":"Youth Day","countryCode":"ZA","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]}],"meta":{"country":"ZA","from":"2026-06-12","to":"2026-07-12","days_window":30,"count":1}}
curl --location --request GET 'https://zylalabs.com/api/12764/sla+deadline+calculator+global+holidays+api/24907/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/12764/sla+deadline+calculator+global+holidays+api/24908/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:569d4f5d-dd72-4b68-9e42-2dd9c5a09ad5
SEQUENCE:0
DTSTAMP:20260612T003450Z
DTSTART;VALUE=DATE:20260101
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:New Year's Day
END:VEVENT
BEGIN:VEVENT
UID:3f4c70c3-827c-4cdb-bec9-82fbfe682c57
SEQUENCE:0
DTSTAMP:20260612T003450Z
DTSTART;VALUE=DATE:20260321
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Human Rights Day
END:VEVENT
BEGIN:VEVENT
UID:52a2f431-10d8-4dbd-90c2-7afb02c73850
SEQUENCE:0
DTSTAMP:20260612T003450Z
DTSTART;VALUE=DATE:20260403
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Good Friday
END:VEVENT
BEGIN:VEVENT
UID:13faa8a9-b22a-4f8b-80f7-6f9dc1b38ffd
SEQUENCE:0
DTSTAMP:20260612T003450Z
DTSTART;VALUE=DATE:20260406
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Family Day
END:VEVENT
BEGIN:VEVENT
UID:62d11271-082b-4740-a192-5c4a5aff5e1b
SEQUENCE:0
DTSTAMP:20260612T003450Z
DTSTART;VALUE=DATE:20260427
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Freedom Day
END:VEVENT
BEGIN:VEVENT
UID:b3c385e5-bd3a-4bdb-9020-9404afb8268e
SEQUENCE:0
DTSTAMP:20260612T003450Z
DTSTART;VALUE=DATE:20260501
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Workers' Day
END:VEVENT
BEGIN:VEVENT
UID:e6f216b0-3e5c-4442-abdf-c53b79a603c3
SEQUENCE:0
DTSTAMP:20260612T003450Z
DTSTART;VALUE=DATE:20260616
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Youth Day
END:VEVENT
BEGIN:VEVENT
UID:ddf95b8a-1a00-422f-a9dd-0c1f0f41094e
SEQUENCE:0
DTSTAMP:20260612T003450Z
DTSTART;VALUE=DATE:20260810
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:National Women's Day
END:VEVENT
BEGIN:VEVENT
UID:af4ce4a8-d839-4997-ac43-51d9dd16dee6
SEQUENCE:0
DTSTAMP:20260612T003450Z
DTSTART;VALUE=DATE:20260924
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Heritage Day
END:VEVENT
BEGIN:VEVENT
UID:9443ac1f-c0ce-4d15-92f1-a97908734899
SEQUENCE:0
DTSTAMP:20260612T003450Z
DTSTART;VALUE=DATE:20261216
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Day of Reconciliation
END:VEVENT
BEGIN:VEVENT
UID:2de0dcdb-4fdc-4f8b-836c-506a76a88b04
SEQUENCE:0
DTSTAMP:20260612T003450Z
DTSTART;VALUE=DATE:20261225
X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
SUMMARY:Christmas Day
END:VEVENT
BEGIN:VEVENT
UID:f3a6e671-5e2c-4341-b788-ff3e79339b3b
SEQUENCE:0
DTSTAMP:20260612T003450Z
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/12764/sla+deadline+calculator+global+holidays+api/24909/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/12764/sla+deadline+calculator+global+holidays+api/24910/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/12764/sla+deadline+calculator+global+holidays+api/24911/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/12764/sla+deadline+calculator+global+holidays+api/24912/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/12764/sla+deadline+calculator+global+holidays+api/24913/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/12764/sla+deadline+calculator+global+holidays+api/24914/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/12764/sla+deadline+calculator+global+holidays+api/24915/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/12764/sla+deadline+calculator+global+holidays+api/24916/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 SLA Deadline Calculator Global Holidays 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 all public holidays for a specified country and year, including details such as the holiday date, local name, and type (e.g., Public, Bank).
Key fields include "date" (holiday date), "localName" (holiday name in the local language), "name" (English name), "countryCode" (ISO code), and "types" (holiday classification).
Users can customize requests by specifying parameters such as "country" (ISO code), "year," "month," and "type" (holiday type) to filter results according to their needs.
This endpoint is useful for calculating deadlines, project timelines, and payment schedules by determining the number of business days between two dates, excluding holidays.
The response includes a "data" array with upcoming holidays, each containing fields like "date," "localName," and "types," along with "meta" information about the query parameters.
This endpoint provides public holidays for a specific country, year, and month, allowing users to see holidays within that timeframe, including counts and types.
If the API returns an empty array, it indicates no holidays for the specified parameters. Users should check their input values, such as the country code or date range, for accuracy.
The API's holiday data is sourced from reliable databases and is refreshed annually to ensure accuracy. Automated processes help maintain data integrity across all endpoints.
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