API de Feriados Nacionais do Brasil
Consulte os feriados nacionais oficiais do Brasil em JSON, com nome, data e tipo. Gratuito em todos os planos e pronto para integrar em minutos.
A API de feriados nacionais retorna, em formato JSON, todos os feriados oficiais válidos para o Brasil inteiro, cada um com nome, data (DD/MM/AAAA) e tipo. O endpoint é gratuito em todos os planos da Feriados API, incluindo o plano Free, e não consome cota mensal de requisições.
Como usar
Faça uma requisição GET para o endpoint de feriados nacionais com sua chave de API. A resposta vem em JSON, pronta para uso.
# Listar feriados nacionais (gratuito)
curl https://feriadosapi.com/api/v1/feriados/nacionais?ano=2026 \
-H "X-API-Key: SUA_CHAVE"
# Resposta
{
"tipo": "NACIONAL",
"ano": "2026",
"feriados": [
{ "nome": "Confraternização Universal", "data": "01/01/2026", "tipo": "NACIONAL" },
{ "nome": "Tiradentes", "data": "21/04/2026", "tipo": "NACIONAL" },
{ "nome": "Dia do Trabalho", "data": "01/05/2026", "tipo": "NACIONAL" },
{ "nome": "Independência do Brasil", "data": "07/09/2026", "tipo": "NACIONAL" },
{ "nome": "Nossa Senhora Aparecida", "data": "12/10/2026", "tipo": "NACIONAL" },
{ "nome": "Finados", "data": "02/11/2026", "tipo": "NACIONAL" },
{ "nome": "Proclamação da República", "data": "15/11/2026", "tipo": "NACIONAL" },
{ "nome": "Natal", "data": "25/12/2026", "tipo": "NACIONAL" }
]
}Autenticação via header X-API-Key ou Authorization: Bearer SUA_CHAVE. Toda resposta inclui o header X-Quota-Remaining.
Cobertura e benefícios
Perguntas frequentes
A API de feriados nacionais é gratuita?
Sim. O endpoint de feriados nacionais é gratuito em todos os planos, incluindo o plano Free, e não consome cota mensal de requisições.
Quais dados a API retorna para cada feriado nacional?
Cada feriado vem em JSON com o nome, a data no formato DD/MM/AAAA e o tipo. Os feriados nacionais valem para todo o território brasileiro.
Como faço autenticação na API?
Use sua chave de API no header X-API-Key ou em Authorization: Bearer SUA_CHAVE. Toda resposta inclui o header X-Quota-Remaining com a cota restante.
A API cobre os feriados nacionais de qualquer ano?
Sim. Você pode filtrar por ano e consultar os feriados nacionais oficiais do Brasil para o ano desejado.
Posso consultar também feriados estaduais e municipais?
Sim. Além dos nacionais, a Feriados API cobre feriados estaduais das 27 UFs e municipais de todos os 5.570 municípios brasileiros, além dos feriados bancários FEBRABAN.