{
"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'
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 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.
A biblioteca de feriados de código aberto, calculada localmente
Feriados apenas Verifique antes de confiar neles para prazos de folha de pagamento ou legais Os finais de semana seguem a convenção de cada país
Cada endpoint retorna dados JSON relacionados a feriados públicos e dias úteis. Por exemplo, o endpoint "Próximos feriados públicos" fornece datas de feriados, nomes, dias da semana e dias de folga, enquanto o endpoint "Verificar se uma data é um feriado" indica se uma data específica é um feriado ou dia comercial
Os campos principais incluem "país" "data" "nome" "dia_da_semana" "é_feriado" e "é_dia_útil" Por exemplo o endpoint "Listar feriados públicos" inclui "contagem" e um array de objetos de feriados com seus respectivos detalhes
Os parâmetros variam por ponto de extremidade. Para "Listar feriados públicos", você pode especificar "país" e "ano". O ponto de extremidade "Contar ou adicionar dias úteis" aceita os parâmetros "início", "fim" ou "adicionar" para personalizar a solicitação com base em suas necessidades
Os dados de resposta são estruturados no formato JSON, normalmente contendo um objeto principal com campos como "país" e "feriados" Cada feriado é representado como um objeto dentro de um array, detalhando sua data, nome e dia da semana
A API fornece informações sobre feriados futuros verifica datas específicas lista feriados por país e ano e calcula dias úteis Cada ponto final serve a propósitos distintos permitindo que os usuários acessem dados abrangentes sobre feriados
Os usuários podem analisar a resposta JSON para extrair informações relevantes, como feriados próximos ou se uma data específica é um feriado. Esses dados podem ser integrados em aplicações para agendamento, planejamento ou fins de conformidade
Casos de uso típicos incluem planejamento de eventos em torno de feriados gerenciamento de horários de funcionários e garantia de conformidade com regulamentos locais de feriados As empresas podem usar a API para automatizar verificações de feriados e cálculos de dias úteis
A precisão dos dados é mantida por meio do uso de uma biblioteca de feriados de código aberto, que é atualizada regularmente e calculada localmente. Os usuários são incentivados a verificar os dados para aplicações críticas, como folha de pagamento ou prazos legais