Pesquise feriados públicos para 55 países calcule prazos de dias úteis encontre o próximo dia útil exporte feriados para iCal e mais tudo suportado por dados JSON versionados sem dependências externas em tempo de execução Cobre 55 países na África Américas Ásia Europa e Oceania para os anos de 2024 a 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"
}'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Feriados Globais e Dias Úteis API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
(Economize 2 meses com cobrança anual 🎉)
Consulte os feriados públicos de 55 países, calcule prazos em dias úteis, encontre o próximo dia útil, exporte feriados para iCal e muito mais — tudo apoiado por dados JSON versionados sem dependências externas em tempo de execução. Abrange 55 países da África, Américas, Ásia, Europa e Oceania para os anos de 2024 a 2027
A API abrange 55 países na África, Américas, Ásia, Europa e Oceania. Use o endpoint GET /countries para recuperar a lista completa com os códigos ISO
Os dados de feriados estão disponíveis para 2024 2025 2026 e 2027 Os dados são atualizados automaticamente a cada janeiro para adicionar o novo ano
O modo comercial conta apenas os dias úteis, pulando os fins de semana e feriados. O modo de calendário conta os dias corridos a partir da data de início e sinaliza se o resultado cair em um feriado ou fim de semana
Sim — use o endpoint Export Holidays to iCal para baixar um arquivo .ics compatível com o Google Calendar, Apple Calendar, Outlook e qualquer aplicativo que suporte o formato iCal
O endpoint de Consulta de Feriados em Massa permite buscar feriados para até 10 países em uma única solicitação ideal para plataformas de RH múltiplos países folha de pagamento e logística
Os dias úteis excluem sábados, domingos e feriados públicos específicos do país. A contagem segue a convenção financeira padrão - inclui a data de início, exclui a data de término
Sim — os dados de feriados são atualizados automaticamente todo janeiro por meio de um pipeline automatizado Nenhuma alteração é necessária por parte dos consumidores da API
Este endpoint retorna uma lista de feriados públicos para um país e ano especificados, incluindo detalhes como a data do feriado, nome local e tipo de feriado. Cada entrada de feriado inclui campos como "data", "nomeLocal", "nome", "códigoPaís" e "tipos"
Os usuários podem personalizar solicitações especificando o código do país, ano e número do mês (1-12). Um parâmetro "tipo" opcional permite filtrar por tipo de feriado, como Público, Banco, Opcional ou Observância
A resposta inclui campos como "data," "nomeLocal," "nome," "códigoCountry," e "tipos" Além disso, metadados como "de," "para," e "janela_dias" fornecem contexto para o período do feriado
Este endpoint fornece uma discriminação da contagem de feriados públicos para cada mês de um ano específico em um determinado país Ele retorna todos os 12 meses incluindo meses com zero feriados junto com a contagem de feriados para cada mês
A resposta é estruturada como um objeto JSON contendo um campo "sucesso" e um campo "dados" O campo "dados" é um objeto onde cada chave é um código de país e o valor é um array de objetos de feriado para esse país
Este endpoint é útil para calcular prazos, cronogramas de projetos ou cronogramas de processamento de pagamentos ao determinar o número de dias úteis entre duas datas, excluindo fins de semana e feriados.
Os usuários podem verificar se uma data específica é um dia útil o que ajuda no agendamento de reuniões definição de prazos ou planejamento de eventos A resposta indica se a data é um dia útil e fornece o dia da semana como referência
Os dados de feriados da API são atualizados anualmente através de um pipeline automatizado, garantindo que reflitam as informações de feriados públicos mais atuais. Este processo ajuda a manter alta qualidade e precisão dos dados em todos os países suportados