Feriados municipais por código IBGE
Feriado municipal no Brasil se consulta pelo código IBGE do município (sete dígitos),
não pelo nome da cidade. Nomes repetem; o código não. A API MuhBianco filtra
/feriados?ano=&ibge= e responde em
/feriados/cobertura se aquele município já tem dado publicado — ou se ainda
não há fonte confirmada.
Por que IBGE e não o nome da cidade
“São Paulo” é capital e também aparece em outros estados. “Bom Jesus” se multiplica.
O código IBGE (exemplo: São Paulo capital 3550308) é o identificador que
folha, ERP e e-commerce já usam. A API segue isso.
Cobertura sem promessa vazia
Nacionais e datas magnas das 27 unidades federativas estão publicados, inclusive os móveis a partir da Páscoa. Municipal é trabalho contínuo: 5.570 prefeituras, cada uma no seu Diário Oficial. Em vez de fingir 100% das cidades, a API diz o estágio daquela localidade — publicado, monitorado, mapeado ou sem dado.
Sem fonte oficial confirmada, a API não inventa a data. Seu sistema precisa tratar “sem dado municipal” como estado conhecido: usar nacional + estadual, avisar o operador ou cair para uma regra sua. Mentir feriado de padroeiro é pior do que admitir buraco.
Exemplo
# Feriados de São Paulo capital em 2026
curl -H "X-API-Key: SUA_CHAVE" \
"https://api.muhbianco.com.br/api/latest/feriados?ano=2026&ibge=3550308"
# O que existe de dado para este município
curl -H "X-API-Key: SUA_CHAVE" \
"https://api.muhbianco.com.br/api/latest/feriados/cobertura?ibge=3550308"Cada feriado retornado traz base legal e fonte. Serve para auditoria: de onde saiu aquela data, não só o nome no calendário. Contrato completo na documentação.
Jornada deste produto
Quem busca feriado municipal por IBGE precisa da API, não do agente no WhatsApp. A jornada é conta, saldo, habilitar, chave — a mesma da landing da API de feriados.