API de Feriados Municipais (5.570 Cidades)

Consulte os feriados municipais de qualquer cidade do Brasil em JSON, por código IBGE. Cobertura de todos os 5.570 municípios.

A API de feriados municipais cobre todos os 5.570 municípios brasileiros, com consulta pelo código IBGE da cidade. As 27 capitais são gratuitas e isentas de cota; os municípios do interior exigem um plano pago. A resposta vem em JSON, com nome, data e tipo de cada feriado.

Como usar

Faça uma requisição GET para o endpoint de feriados por município, informando o código IBGE da cidade. A resposta vem em JSON.

# Feriados da cidade de São Paulo (capital, IBGE 3550308, gratuita)
curl https://feriadosapi.com/api/v1/feriados/cidade/3550308?ano=2026 \
  -H "X-API-Key: SUA_CHAVE"

# Resposta (nacionais + estaduais + municipais da cidade)
{
  "cidade": { "ibge": 3550308, "nome": "São Paulo", "uf": "SP" },
  "ano": "2026",
  "feriados": [
    { "nome": "Confraternização Universal", "data": "01/01/2026", "tipo": "NACIONAL" },
    { "nome": "Aniversário de São Paulo", "data": "25/01/2026", "tipo": "MUNICIPAL" },
    { "nome": "Consciência Negra", "data": "20/11/2026", "tipo": "NACIONAL" }
  ]
}

Autenticação via header X-API-Key ou Authorization: Bearer SUA_CHAVE. Toda resposta inclui o header X-Quota-Remaining.

Capitais gratuitas e municípios do interior

27 capitais (gratuitas)

As 27 capitais estaduais são gratuitas no endpoint de feriados por município e não consomem cota mensal. Ideal para começar a integrar sem custo.

Municípios do interior (plano pago)

Os demais municípios brasileiros exigem um plano pago. A cobertura completa abrange os 5.570 municípios do país.

Planos com acesso aos municípios do interior

Todos os planos pagos cobrem os 5.570 municípios. Escolha conforme o volume de requisições.

Plano	Preço	Requisições/mês	Limite de taxa	Usuários
Developer	R$39/mês	5.000	60 req/min	Até 3
Starter	R$99/mês	100.000	Sem limite de taxa	Até 10
Professional	R$249/mês	1.000.000	Sem limite de taxa	Ilimitados

Cobertura e benefícios

Cobertura de todos os 5.570 municípios brasileiros.

As 27 capitais são gratuitas e isentas de cota.

Consulta por código IBGE, com resposta em JSON.

Cobertura completa: nacionais, estaduais (27 UFs), municipais e bancários FEBRABAN.

API REST em JSON e servidor MCP em mcp.feriadosapi.com.

Planos pagos a partir de R$39 por mês para os municípios do interior.

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. As 27 capitais são gratuitas no endpoint de feriados por município e não consomem cota. Os municípios do interior exigem um plano pago.

Como consulto os feriados de uma cidade?

Faça uma requisição GET para /api/v1/feriados/cidade/{ibge}, informando o código IBGE da cidade. Por exemplo, 3550308 para São Paulo. A resposta vem em JSON.

Qual plano preciso para municípios do interior?

Para consultar municípios do interior é preciso um plano pago. O Developer custa R$39 por mês com 5.000 requisições mensais. O Starter custa R$99 por mês com 100.000. O Professional custa R$249 por mês com 1.000.000.

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.

Recursos relacionados

API de Feriados

Visão geral da API e de todos os endpoints.

Feriados Nacionais

Feriados oficiais válidos para todo o Brasil.

Feriados Estaduais

Consulta por UF nas 27 unidades federativas.

Feriados de São Paulo

Página de exemplo com feriados por estado.

Documentação

Guia completo de integração e autenticação.

Pronto para integrar?

Criar Conta Grátis