BrasilAPI Feriados

Consulte os feriados retornados para um ano pela BrasilAPI e confira data, nome, tipo e dia da semana antes de montar um calendário.

Documentação

Resposta pública atual

Carregue a lista de feriados para 2026.

O que a consulta retorna

Consulte os feriados retornados para um ano pela BrasilAPI e confira data, nome, tipo e dia da semana antes de montar um calendário.

O retorno de 2026 traz campos date, name, type e weekday. Um registro nacional não confirma expediente de loja, empresa, escola, repartição ou serviço de uma cidade específica.

Campos que merecem atenção

data
nome do feriado
tipo
dia da semana

Uma lista para o ano consultado

A rota recebe o ano na URL e devolve os feriados que a fonte lista para aquele período. Em 2026, por exemplo, a resposta inclui Tiradentes, Dia do Trabalho, Independência do Brasil e Natal. Trocar o ano é parte da consulta: não use a lista de um ano como se fosse um calendário permanente.

Monte a URL com o ano que o calendário realmente precisa mostrar.
Guarde a data junto com o ano retornado, em vez de salvar apenas dia e mês.
Atualize a consulta ao iniciar um novo planejamento anual.

Como ler os campos retornados

Cada item observado traz date, name, type e weekday. date identifica a data em formato numérico; name apresenta o nome usado pela fonte; type classifica o item; weekday informa o dia da semana em português. Esses campos servem para exibir e organizar a resposta, não para preencher informações que ela não fornece.

Use date como base para ordenar a agenda ou gerar uma data local na interface.
Exiba name como rótulo do item, preservando o texto retornado.
Trate type e weekday como dados da fonte e mantenha espaço para mudanças futuras no formato.

Onde a consulta ajuda

A lista é útil para destacar datas em agenda, calcular prazos internos, preparar conteúdo sazonal ou lembrar a equipe de conferir um feriado próximo. Também pode servir como ponto de partida para calendários de viagem e comunicação, desde que a decisão final considere o lugar e a atividade envolvidos.

Sinalize datas no calendário sem presumir que todos os serviços param.
Revise prazos de atendimento e entrega com os responsáveis por cada operação.
Em aplicativos, deixe claro qual ano foi carregado e quando a lista foi atualizada.

Limites antes de tomar uma decisão

A presença de um item na resposta não prova que um comércio, escola, órgão ou transporte estará fechado. Feriados estaduais, municipais, pontos facultativos, escalas de trabalho e regras internas podem alterar o efeito prático daquela data. Para compromissos importantes, confirme diretamente com o órgão, a empresa ou o destino.

Não deduza horário de funcionamento apenas pelo campo type.
Consulte fontes locais quando a atividade depender de cidade ou estado.
Use confirmação humana para viagem, atendimento, pagamento ou prazo que não possa falhar.