API de Feriados do Brasil
Consulte feriados nacionais, estaduais, municipais e bancários de todo o Brasil com uma única API REST em JSON. Comece de graça em minutos.
A Feriados API é uma API REST que retorna feriados nacionais, estaduais, municipais e bancários (FEBRABAN) de todos os 5.570 municípios brasileiros em formato JSON, com servidor MCP para agentes de IA.
Explore os tipos de feriado
Cada tipo de feriado tem seu endpoint dedicado. Escolha o que faz sentido para a sua integração.
Feriados Nacionais
Os feriados nacionais do Brasil, com datas fixas e móveis calculadas automaticamente para qualquer ano.
Feriados Estaduais
Feriados oficiais dos 27 estados (26 UFs e o Distrito Federal), consultados por sigla do estado.
Feriados Municipais
Feriados de todos os 5.570 municípios brasileiros, consultados pelo código IBGE da cidade.
Feriados Bancários
Feriados bancários segundo o calendário FEBRABAN e verificação de dia útil bancário por data.
Uma chamada, todos os feriados
A autenticação usa uma chave de API enviada no header X-API-Key ou em Authorization: Bearer <KEY>. Toda resposta inclui o header X-Quota-Remaining com a cota restante.
curl https://feriadosapi.com/api/v1/feriados/nacionais \
-H "X-API-Key: SUA_CHAVE"
# Resposta (JSON)
{
"tipo": "NACIONAL",
"ano": "2026",
"feriados": [
{ "data": "01/01/2026", "nome": "Confraternização Universal", "tipo": "NACIONAL" },
{ "data": "21/04/2026", "nome": "Tiradentes", "tipo": "NACIONAL" }
]
}Principais endpoints
GET /api/v1/feriados # lista com filtros (data, tipo, UF, IBGE)
GET /api/v1/feriados/nacionais # feriados nacionais (grátis)
GET /api/v1/feriados/estado/{uf} # feriados por estado, 27 UFs (grátis)
GET /api/v1/feriados/cidade/{ibge} # feriados por município, 5.570 cidades (capitais grátis)
GET /api/v1/feriados/bancarios # feriados bancários FEBRABAN (grátis)
GET /api/v1/feriados/dia-util-bancario/{data} # verifica dia útil bancário (grátis)
GET /api/v1/estados # lista estados
GET /api/v1/municipios # lista municípios por UF
GET /api/v1/municipio/{ibge} # informações do municípioNo plano gratuito, feriados nacionais, estaduais, as 27 capitais e as consultas de localidade estão disponíveis (limite de 60 requisições por minuto, até 3 usuários). Municípios do interior exigem um plano pago a partir do Developer (R$39 por mês, 5.000 requisições mensais, todos os 5.570 municípios).
Perguntas frequentes
O que é a API de Feriados do Brasil?
A Feriados API é uma API REST que retorna feriados nacionais, estaduais, municipais e bancários (FEBRABAN) de todos os 5.570 municípios brasileiros em formato JSON. Inclui também um servidor MCP para integração com agentes de IA.
Quais tipos de feriado a API cobre?
A API cobre feriados nacionais, feriados estaduais dos 27 estados (26 UFs e o Distrito Federal), feriados municipais de todos os 5.570 municípios e feriados bancários segundo o calendário FEBRABAN.
A API de feriados é gratuita ou paga?
O plano gratuito dá acesso a feriados nacionais, feriados estaduais, as 27 capitais e consultas de localidade, com limite de 60 requisições por minuto e até 3 usuários. Municípios do interior exigem um plano pago. O plano Developer custa R$39 por mês com 5.000 requisições mensais e acesso a todos os 5.570 municípios.
Em qual formato a API retorna os dados?
Todas as respostas são em JSON via API REST. A autenticação usa uma chave de API enviada no header X-API-Key ou em Authorization: Bearer <KEY>, e cada resposta inclui o header X-Quota-Remaining com a cota restante.
A API funciona com agentes de IA?
Sim. Além da API REST em JSON, oferecemos um servidor MCP em https://mcp.feriadosapi.com que permite que agentes de IA consultem feriados brasileiros diretamente.