{
"country": "ES",
"state": "MD",
"year": 2026,
"count": 14,
"holidays": [
{
"date": "2026-01-01",
"name": "New Year's Day",
"type": "public",
"substitute": false
},
{
"date": "2026-01-06",
"name": "Epiphany",
"type": "public",
"substitute": false
},
{
"date": "2026-04-02",
"name": "Maundy Thursday",
"type": "public",
"substitute": false
},
{
"date": "2026-04-03",
"name": "Good Friday",
"type": "public",
"substitute": false
},
{
"date": "2026-05-01",
"name": "Labour Day",
"type": "public",
"substitute": false
},
{
"date": "2026-05-02",
"name": "Día de la Comunidad de Madrid",
"type": "public",
"substitute": false
},
{
"date": "2026-08-15",
"name": "Assumption",
"type": "public",
"substitute": false
},
{
"date": "2026-10-12",
"name": "Fiesta Nacional de España",
"type": "public",
"substitute": false
},
{
"date": "2026-11-01",
"name": "All Saints' Day",
"type": "public",
"substitute": false
},
{
"date": "2026-11-02",
"name": "All Saints' Day (substitute day)",
"type": "public",
"substitute": true
},
{
"date": "2026-12-06",
"name": "Día de la Constitución Española",
"type": "public",
"substitute": false
},
{
"date": "2026-12-07",
"name": "Día de la Constitución Española (substitute day)",
"type": "public",
"substitute": true
},
{
"date": "2026-12-08",
"name": "Immaculate Conception",
"type": "public",
"substitute": false
},
{
"date": "2026-12-25",
"name": "Christmas Day",
"type": "public",
"substitute": false
}
],
"source": "date-holidays (CC BY 3.0 data)"
}
curl --location --request GET 'https://zylalabs.com/api/14211/public+holidays+api+-+100+plus+countries/35278/holidays+of+a+year?country=ES&year=2026&state=MD&types=public&lang=en' --header 'Authorization: Bearer YOUR_API_KEY'
{
"country": "US",
"date": "2026-12-25",
"isHoliday": true,
"holidays": [
{
"name": "Christmas Day",
"type": "public"
}
],
"source": "date-holidays (CC BY 3.0 data)"
}
curl --location --request GET 'https://zylalabs.com/api/14211/public+holidays+api+-+100+plus+countries/35279/is+it+a+holiday?country=US&date=2026-12-25' --header 'Authorization: Bearer YOUR_API_KEY'
{
"country": "DE",
"states": {
"BB": "Brandenburg",
"BE": "Berlin",
"BW": "Baden-Württemberg",
"BY": "Bayern",
"HB": "Hansestadt Bremen",
"HE": "Hessen",
"HH": "Hansestadt Hamburg",
"MV": "Mecklenburg-Vorpommern",
"NI": "Niedersachsen",
"NW": "Nordrhein-Westfalen",
"RP": "Rheinland-Pfalz",
"SH": "Schleswig-Holstein",
"SL": "Saarland",
"SN": "Sachsen",
"ST": "Sachsen-Anhalt",
"TH": "Thüringen"
}
}
curl --location --request GET 'https://zylalabs.com/api/14211/public+holidays+api+-+100+plus+countries/35280/countries+and+regions?country=DE' --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 API de Feriados Públicos - Mais de 100 Países 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.
Cada endpoint retorna dados relacionados a feriados públicos e bancários de mais de 100 países e suas regiões O endpoint "Feriados de um ano" fornece uma lista de feriados para um ano especificado enquanto o endpoint "É feriado?" verifica se uma data específica é um feriado O endpoint "Países e regiões" lista os países disponíveis e suas subdivisões
Os campos-chave incluem "país", "estado", "ano", "contagem", "feriados" (com detalhes como "data", "nome", "tipo" e "substituto") e "éFeriado" para verificações de data Esses campos fornecem informações essenciais sobre feriados e suas características
Os principais parâmetros incluem "país", "estado" e "ano" para o endpoint "Feriados de um ano", e "data" para o endpoint "É um feriado?" Os usuários podem especificar esses parâmetros para personalizar seus pedidos de dados com base em suas necessidades
Os dados de resposta estão estruturados no formato JSON Por exemplo o endpoint "Feriados de um ano" retorna um objeto contendo o código do país estado ano contagem de feriados e um array de objetos de feriado cada um detalhando a data nome tipo e status de substituição
Os dados são obtidos de date-holidays (CC BY 3.0) Isso garante que as informações estejam disponíveis publicamente e possam ser usadas livremente ao mesmo tempo que mantém um nível de transparência em relação à origem dos dados
Casos de uso típicos incluem planejar eventos em torno de feriados desenvolver aplicações que requerem consciência dos feriados e fornecer informações de feriados localizadas para empresas e viajantes Esses dados podem melhorar a experiência do usuário integrando a consciência dos feriados em vários serviços
Os usuários podem utilizar os dados retornados analisando a resposta JSON para extrair informações relevantes sobre feriados Por exemplo, eles podem verificar se uma data específica é um feriado e exibir nomes de feriados localizados em aplicativos, aumentando o envolvimento e a funcionalidade dos usuários
A precisão dos dados é mantida através de atualizações regulares e verificações contra fontes confiáveis A API aproveita uma abordagem impulsionada pela comunidade permitindo que correções e melhorias sejam feitas garantindo que os usuários recebam as informações de feriados mais precisas disponíveis