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

Brasil (nacionais, facultativos e estaduais)
GET https://feriadosecalendarios.com.br/api/v1/feriados/brasil/2027.json
Portugal (nacionais e tolerâncias de ponto)
GET https://feriadosecalendarios.com.br/api/v1/feriados/portugal/2027.json
Planilha CSV dos feriados (nacionais, estaduais e municipais)
GET https://feriadosecalendarios.com.br/api/v1/feriados/brasil/2027.csv
Planilha CSV de dias úteis por mês (com 5º dia útil)
GET https://feriadosecalendarios.com.br/api/v1/feriados/brasil/dias-uteis-2027.csv

Troque 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:

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.