API de feriados
Os feriados do Brasil e de Portugal em JSON, grátis e sem cadastro: faça um GET em /api/v1/feriados/brasil/2027.json. CORS aberto, servido por CDN, com a fonte oficial de cada data. Só pedimos crédito com link.
Endpoints
GET https://feriadosecalendarios.com.br/api/v1/feriados/brasil/2027.jsonGET https://feriadosecalendarios.com.br/api/v1/feriados/portugal/2027.jsonGET https://feriadosecalendarios.com.br/api/v1/feriados/brasil/2027.csvGET https://feriadosecalendarios.com.br/api/v1/feriados/brasil/dias-uteis-2027.csvTroque o ano (2025, 2026, 2027, 2028, 2029) ou o país (brasil, portugal) no endereço. Ano fora do intervalo responde 404. Os CSV usam ; como separador e UTF-8 com BOM, para abrir direto no Excel.
Exemplo de resposta
{
"pais": { "codigo": "BR", "nome": "Brasil" },
"ano": 2027,
"atualizado_em": "2026-11-19",
"fonte": { "texto": "Lei nº 662/1949, …", "url": "https://www.planalto.gov.br/…" },
"credito": "Dados: Feriados e Calendários (https://feriadosecalendarios.com.br)",
"feriados": [
{
"data": "2027-01-01",
"nome": "Confraternização Universal",
"tipo": "nacional",
"tipo_descricao": "Feriado nacional",
"dia_semana": "…",
"url": "https://feriadosecalendarios.com.br/brasil/feriados/2027/confraternizacao-universal"
}
],
"estaduais": [
{ "uf": "SP", "estado": "São Paulo", "data": "2027-07-09", "nome": "Revolução Constitucionalista", … }
]
}Em JavaScript
const r = await fetch("https://feriadosecalendarios.com.br/api/v1/feriados/brasil/2027.json");
const { feriados } = await r.json();
const nacionais = feriados.filter((f) => f.tipo === "nacional");Campo tipo: nacional, facultativo (ponto facultativo / tolerância de ponto) ou comemorativa (não é folga).
Calendário .ics (iCalendar)
Para agendas e sistemas que leem iCalendar:
- https://feriadosecalendarios.com.br/agenda/brasil.ics
- https://feriadosecalendarios.com.br/agenda/portugal.ics
- https://feriadosecalendarios.com.br/agenda/brasil-sao-paulo.ics
- https://feriadosecalendarios.com.br/agenda/brasil-rio-de-janeiro.ics
- https://feriadosecalendarios.com.br/agenda/brasil-bahia.ics
- https://feriadosecalendarios.com.br/agenda/brasil-rio-grande-do-sul.ics
- https://feriadosecalendarios.com.br/agenda/brasil-pernambuco.ics
- https://feriadosecalendarios.com.br/agenda/brasil-ceara.ics
- https://feriadosecalendarios.com.br/agenda/brasil-para.ics
- https://feriadosecalendarios.com.br/agenda/brasil-amazonas.ics
- https://feriadosecalendarios.com.br/agenda/brasil-maranhao.ics
- https://feriadosecalendarios.com.br/agenda/brasil-paraiba.ics
- https://feriadosecalendarios.com.br/agenda/brasil-rio-grande-do-norte.ics
- https://feriadosecalendarios.com.br/agenda/brasil-alagoas.ics
- https://feriadosecalendarios.com.br/agenda/brasil-sergipe.ics
- https://feriadosecalendarios.com.br/agenda/brasil-piaui.ics
- https://feriadosecalendarios.com.br/agenda/brasil-espirito-santo.ics
- https://feriadosecalendarios.com.br/agenda/brasil-acre.ics
- https://feriadosecalendarios.com.br/agenda/brasil-amapa.ics
- https://feriadosecalendarios.com.br/agenda/brasil-tocantins.ics
- https://feriadosecalendarios.com.br/agenda/brasil-mato-grosso-do-sul.ics
- https://feriadosecalendarios.com.br/agenda/brasil-santa-catarina.ics
- https://feriadosecalendarios.com.br/agenda/brasil-rondonia.ics
- https://feriadosecalendarios.com.br/agenda/brasil-roraima.ics
- https://feriadosecalendarios.com.br/agenda/brasil-sao-paulo-sp.ics
- https://feriadosecalendarios.com.br/agenda/brasil-rio-de-janeiro-rj.ics
- https://feriadosecalendarios.com.br/agenda/brasil-belo-horizonte-mg.ics
- https://feriadosecalendarios.com.br/agenda/brasil-salvador-ba.ics
- https://feriadosecalendarios.com.br/agenda/brasil-recife-pe.ics
- https://feriadosecalendarios.com.br/agenda/brasil-porto-alegre-rs.ics
- https://feriadosecalendarios.com.br/agenda/brasil-curitiba-pr.ics
- https://feriadosecalendarios.com.br/agenda/brasil-fortaleza-ce.ics
- https://feriadosecalendarios.com.br/agenda/brasil-manaus-am.ics
- https://feriadosecalendarios.com.br/agenda/brasil-goiania-go.ics
- https://feriadosecalendarios.com.br/agenda/brasil-sao-luis-ma.ics
- https://feriadosecalendarios.com.br/agenda/brasil-maceio-al.ics
- https://feriadosecalendarios.com.br/agenda/brasil-natal-rn.ics
- https://feriadosecalendarios.com.br/agenda/brasil-teresina-pi.ics
- https://feriadosecalendarios.com.br/agenda/brasil-joao-pessoa-pb.ics
- https://feriadosecalendarios.com.br/agenda/brasil-aracaju-se.ics
- https://feriadosecalendarios.com.br/agenda/brasil-campo-grande-ms.ics
- https://feriadosecalendarios.com.br/agenda/brasil-cuiaba-mt.ics
- https://feriadosecalendarios.com.br/agenda/brasil-florianopolis-sc.ics
- https://feriadosecalendarios.com.br/agenda/brasil-vitoria-es.ics
- https://feriadosecalendarios.com.br/agenda/brasil-porto-velho-ro.ics
- https://feriadosecalendarios.com.br/agenda/brasil-macapa-ap.ics
- https://feriadosecalendarios.com.br/agenda/brasil-rio-branco-ac.ics
- https://feriadosecalendarios.com.br/agenda/brasil-boa-vista-rr.ics
- https://feriadosecalendarios.com.br/agenda/portugal-lisboa.ics
- https://feriadosecalendarios.com.br/agenda/portugal-porto.ics
- https://feriadosecalendarios.com.br/agenda/portugal-vila-nova-de-gaia.ics
- https://feriadosecalendarios.com.br/agenda/portugal-matosinhos.ics
- https://feriadosecalendarios.com.br/agenda/portugal-braga.ics
- https://feriadosecalendarios.com.br/agenda/portugal-guimaraes.ics
- https://feriadosecalendarios.com.br/agenda/portugal-coimbra.ics
- https://feriadosecalendarios.com.br/agenda/portugal-aveiro.ics
- https://feriadosecalendarios.com.br/agenda/portugal-leiria.ics
- https://feriadosecalendarios.com.br/agenda/portugal-viseu.ics
- https://feriadosecalendarios.com.br/agenda/portugal-guarda.ics
- https://feriadosecalendarios.com.br/agenda/portugal-santarem.ics
- https://feriadosecalendarios.com.br/agenda/portugal-sintra.ics
- https://feriadosecalendarios.com.br/agenda/portugal-amadora.ics
- https://feriadosecalendarios.com.br/agenda/portugal-cascais.ics
- https://feriadosecalendarios.com.br/agenda/portugal-oeiras.ics
- https://feriadosecalendarios.com.br/agenda/portugal-loures.ics
- https://feriadosecalendarios.com.br/agenda/portugal-odivelas.ics
- https://feriadosecalendarios.com.br/agenda/portugal-almada.ics
- https://feriadosecalendarios.com.br/agenda/portugal-seixal.ics
- https://feriadosecalendarios.com.br/agenda/portugal-setubal.ics
- https://feriadosecalendarios.com.br/agenda/portugal-evora.ics
- https://feriadosecalendarios.com.br/agenda/portugal-beja.ics
- https://feriadosecalendarios.com.br/agenda/portugal-portalegre.ics
- https://feriadosecalendarios.com.br/agenda/portugal-faro.ics
- https://feriadosecalendarios.com.br/agenda/portugal-viana-do-castelo.ics
- https://feriadosecalendarios.com.br/agenda/portugal-vila-real.ics
- https://feriadosecalendarios.com.br/agenda/portugal-braganca.ics
- https://feriadosecalendarios.com.br/agenda/portugal-funchal.ics
- https://feriadosecalendarios.com.br/agenda/portugal-ponta-delgada.ics
- https://feriadosecalendarios.com.br/agenda/portugal-angra-do-heroismo.ics
Para pessoas: assinar os feriados no Google Agenda, iPhone ou Outlook.
Crédito
Use livremente; só pedimos um link visível perto de onde os dados aparecem:
Dados de feriados: <a href="https://feriadosecalendarios.com.br">Feriados e Calendários</a>
Perguntas frequentes
A API é gratuita?
Sim, para uso pessoal e comercial. Pedimos apenas o crédito com link visível para o site.
Tem limite de requisições?
Os arquivos são estáticos e servidos por CDN. Faça cache do seu lado (os dados mudam poucas vezes por ano) e evite consultar a cada visita.
Quais anos estão disponíveis?
De 2025 a 2029. O intervalo avança automaticamente a cada ano.
De onde vêm as datas?
Das leis de cada país e estado, calculadas por regra (feriados móveis a partir da Páscoa) e conferidas por uma pessoa. A fonte está no campo “fonte” e em cada página.
Encontrou um erro ou precisa de outro formato? Fale com a gente.