A API cobre feriado municipal?

Feriados nacionais e as datas magnas estaduais estão publicados para todo o país. Feriado municipal é declarado por município no endpoint /feriados/cobertura: ele responde se aquele município já tem dado publicado, monitorado ou nenhum. A API não inventa data que não foi confirmada em fonte oficial.

Como autentico as chamadas?

Com o cabeçalho X-API-Key. A chave é gerada na sua conta MuhBianco depois de habilitar o serviço. Não há OAuth nem token de expiração curta.

Existe limite de requisições?

São 10.000 requisições por dia por assinatura, com o contador zerando à meia-noite UTC. Passar do limite devolve HTTP 429 com o cabeçalho Retry-After. Excesso nunca vira cobrança extra no saldo.

De onde vem a base legal de cada feriado?

Cada feriado retorna o campo base_legal (a lei ou decreto que o instituiu) e, quando extraído de Diário Oficial, a fonte_url do documento. Feriados móveis como Carnaval e Corpus Christi são calculados a partir da Páscoa e vêm marcados como facultativos.

API de feriados do Brasil em JSON — com a lei que criou cada data.

Nacional, estadual e municipal por código IBGE. Cálculo de dias úteis entre duas datas. Cada feriado vem com a base legal e a fonte de onde saiu, para você conseguir auditar depois — não uma lista solta que ninguém sabe de onde veio.

Começar a API de Feriados Ver a documentação

Serviço digital, sem envio físico. Cancele na conta: se o período ainda não foi usado, o valor volta para o saldo. Cancelamento e reembolso.

Por que isso dá trabalho sem uma API

Feriado nacional é fácil: são doze datas e quase ninguém erra. O problema começa no município. São 5.570 prefeituras publicando decreto em Diário Oficial, cada uma no seu calendário, e o feriado do aniversário da cidade muda a folha, o SLA do contrato, a entrega e o prazo processual. Manter isso numa tabela no seu banco vira dívida no primeiro ano em que alguém esquece de atualizar.

O que a API entrega

Feriados por ano, filtrando por UF, nome da cidade ou código IBGE do município
Dias úteis entre duas datas, já descontando fim de semana e feriado
Cobertura declarada: o que existe de fato para aquele município
Base legal e fonte em cada feriado retornado
Ponto facultativo (Carnaval, Corpus Christi) separado do feriado obrigatório

O que ela não faz

Não inventa feriado municipal que não foi confirmado em fonte oficial
Não devolve ano fora da janela publicada — recusa com erro explícito
Não é calendário corporativo: recesso interno da sua empresa é seu
Não cobra por requisição: o excesso vira 429, nunca débito no saldo

Três endpoints, um cabeçalho

Autenticação é X-API-Key. Sem OAuth, sem token que expira no meio do seu job noturno. A resposta é JSON com data ISO.

# Feriados de São Paulo capital em 2026 (por nome da cidade)
curl -H "X-API-Key: SUA_CHAVE" \
  "https://api.muhbianco.com.br/api/latest/feriados?ano=2026&cidade=São Paulo&uf=SP"

# O mesmo município pelo código IBGE
curl -H "X-API-Key: SUA_CHAVE" \
  "https://api.muhbianco.com.br/api/latest/feriados?ano=2026&ibge=3550308"

# Dias úteis entre duas datas
curl -H "X-API-Key: SUA_CHAVE" \
  "https://api.muhbianco.com.br/api/latest/feriados/dias-uteis?de=2026-09-01&ate=2026-09-30&uf=SP"

# 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"

Documentação completa: parâmetros, respostas e erros

Cobertura sem promessa vazia

Feriados nacionais e as datas magnas das 27 unidades federativas estão publicados, incluindo os móveis calculados a partir da Páscoa. O municipal é o trabalho contínuo: em vez de fingir cobertura total, a API responde por município no /feriados/cobertura em qual estágio aquela cidade está — publicado, monitorado, mapeado ou sem dado. Você decide o que fazer com isso, sabendo o que tem na mão.

Perguntas frequentes

A API cobre feriado municipal?

Nacionais e datas magnas estaduais estão publicados para todo o país. Municipal é declarado cidade a cidade no /feriados/cobertura: ele diz se aquele município já tem dado publicado, monitorado ou nenhum. A API não inventa data que não foi confirmada em fonte oficial.
Como autentico as chamadas?

Com o cabeçalho X-API-Key. A chave é gerada na sua conta MuhBianco depois de habilitar o serviço, em Serviços → Configurações do serviço. Você pode manter até cinco chaves ativas e revogar qualquer uma na hora.
Existe limite de requisições?

São 10.000 requisições por dia por assinatura, com o contador zerando à meia-noite UTC. Passar disso devolve 429 com o cabeçalho Retry-After. Excesso nunca vira cobrança extra no saldo — o limite é técnico, não comercial.
Preciso confirmar WhatsApp para usar?

Não. Este produto não tem agente nem canal de WhatsApp. Criar conta, adicionar saldo, habilitar o serviço e gerar a chave — só isso.
Posso cancelar e receber o valor de volta?

Sim. Na conta você cancela para não renovar ao fim do período pago. Se o período de 30 dias ainda não foi usado, o valor volta para o saldo. Regras em Cancelamento e reembolso.

Guias deste assunto

Pronto para integrar?

Conta, saldo, habilitar, gerar chave. A primeira chamada sai no mesmo dia.

Começar a API de Feriados Ler a documentação