Sobre esta API

Consulte feriados nacionais, estaduais e municipais brasileiros. Lista completa com feriados fixos (8) e móveis (Carnaval, Páscoa, Sexta-feira Santa, Corpus Christi). Suporte a filtros por período, UF e município. Feriados estaduais para todos os 27 estados. Feriados municipais para as principais capitais. Verificação se uma data específica é feriado. Próximos feriados a partir da data atual. Ideal para sistemas de agendamento, cálculo de prazos, recursos humanos, calendários escolares e planejamento de eventos.

Principais recursos

Feriados nacionais

8 feriados fixos + 4 móveis (Carnaval, Páscoa, etc)

Feriados estaduais

Todos os 27 estados brasileiros

Feriados municipais

Principais capitais e cidades

Filtros avançados

Por período, UF, município e tipo

Consulta por data

Verifica se uma data específica é feriado

99.9% Uptime

Disponibilidade garantida

Cache 24 horas

Dados imutáveis em cache para alta performance

Documentação adicional

Feriados nacionais fixos (8): Confraternização Universal, Tiradentes, Dia do Trabalho, Independência, Nossa Senhora Aparecida, Finados, Proclamação da República, Natal. Feriados móveis: Carnaval, Sexta-feira Santa, Páscoa, Corpus Christi. Feriados estaduais para todos os 27 estados. Feriados municipais para as principais capitais. Cache de 24 horas para dados imutáveis.

Informações técnicas

Endpoint feriados.apibrasil.pro
Cache 24 horas
Preço Gratuito
Autenticação API Key (Bearer)
Formato JSON
Rate Limit 200 req/min
Limite Grátis 1,000 req/mês

Documentação

Endpoints da API Feriados

Exemplos de requisições, parâmetros e respostas para cada endpoint.

GET /feriados

Lista feriados com filtros por período, UF e município

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`inicio`	string	❌ Não	Data inicial (YYYY-MM-DD)
`fim`	string	❌ Não	Data final (YYYY-MM-DD)
`ano`	number	❌ Não	Ano (ex: 2026)
`uf`	string	❌ Não	UF (SP, RJ, etc)
`municipio`	string	❌ Não	Município (ex: SaoPaulo)
`tipo`	string	❌ Não	nacional, estadual, municipal, todos

curl -X GET "https://feriados.apibrasil.pro/feriados?ano=2026&uf=SP&municipio=SaoPaulo&tipo=todos" -H "Authorization: Bearer sk_live_dcaddc95473df193c89609c4f6b26d0d9748185b79aa4111"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Feriados"
  }
}

GET /feriado/{data}

Verifica se uma data específica é feriado

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`data`	string	✅ Sim	Data a verificar (YYYY-MM-DD)
`uf`	string	❌ Não	UF para considerar feriados estaduais

curl -X GET "https://feriados.apibrasil.pro/feriado/2026-01-01?uf=SP" -H "Authorization: Bearer sk_live_dcaddc95473df193c89609c4f6b26d0d9748185b79aa4111"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Feriados"
  }
}

GET /proximos-feriados

Lista os próximos feriados a partir da data atual

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`quantidade`	number	❌ Não	Número de feriados (1-20, padrão: 5)
`uf`	string	❌ Não	UF para considerar feriados estaduais

curl -X GET "https://feriados.apibrasil.pro/proximos-feriados?quantidade=5&uf=SP" -H "Authorization: Bearer sk_live_dcaddc95473df193c89609c4f6b26d0d9748185b79aa4111"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Feriados"
  }
}

GET /estados

Lista todos os estados com seus feriados estaduais

curl -X GET "https://feriados.apibrasil.pro/estados" -H "Authorization: Bearer sk_live_dcaddc95473df193c89609c4f6b26d0d9748185b79aa4111"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Feriados"
  }
}

GET /api/health

Health check da API

curl -X GET "https://feriados.apibrasil.pro/api/health"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Feriados"
  }
}

Pronto para começar?

Obtenha sua API Key e comece a integrar Feriados hoje mesmo.

Acessar Dashboard Ver planos

Feriados

Sobre esta API

Principais recursos

Feriados nacionais

Feriados estaduais

Feriados municipais

Filtros avançados

Consulta por data

99.9% Uptime

Cache 24 horas

Documentação adicional

Informações técnicas

Precisa de ajuda?

Teste a API Feriados

Testar Feriados

Endpoints da API Feriados

Parâmetros

Parâmetros

Parâmetros

Pronto para começar?

Escolha o plano ideal para seu negócio

Precisa de um plano personalizado?