API de Feriados Municipais do Brasil
Consulte os feriados de qualquer um dos 5.570 municípios brasileiros em formato JSON, usando o código IBGE de 7 dígitos da cidade.
A API de feriados municipais cobre todos os 5.570 municípios do Brasil através da consulta por código IBGE de 7 dígitos. As 27 capitais são gratuitas em todos os planos. Para municípios do interior, é necessário um plano pago a partir do Developer.
Como usar
Informe o código IBGE de 7 dígitos do município no endpoint. A API retorna em JSON os feriados válidos naquela cidade, incluindo feriados locais.
# Consultar feriados da cidade de São Paulo (IBGE: 3550308)
curl https://feriadosapi.com/api/v1/feriados/cidade/3550308?ano=2026 \
-H "X-API-Key: SUA_CHAVE"
# Resposta
[
{ "nome": "Aniversário de São Paulo", "data": "25/01/2026", "tipo": "MUNICIPAL", "ibge": "3550308" },
{ "nome": "Consciência Negra", "data": "20/11/2026", "tipo": "MUNICIPAL", "ibge": "3550308" }
]Autenticação via header X-API-Key ou Authorization: Bearer SUA_CHAVE. A cota restante é informada no header X-Quota-Remaining.
Cobertura e benefícios
Perguntas frequentes
Quantos municípios a API de feriados municipais cobre?
A API cobre todos os 5.570 municípios brasileiros. A consulta é feita pelo código IBGE de 7 dígitos da cidade.
As capitais são gratuitas?
Sim. A consulta de feriados municipais para as 27 capitais brasileiras é gratuita em todos os planos, sem consumo de cota.
E os municípios do interior?
A consulta de municípios que não são capitais requer um plano pago, a partir do Developer (R$39/mês para 5.000 requisições mensais).
O que é o código IBGE do município?
É o código de 7 dígitos atribuído pelo Instituto Brasileiro de Geografia e Estatística a cada município. Exemplo: 3550308 para São Paulo, 3304557 para o Rio de Janeiro.
Como descubro o código IBGE de uma cidade?
Você pode usar o endpoint GET /api/v1/municipios?uf=SP para listar os municípios e códigos de um estado, ou consultar tabelas públicas do IBGE.