Feriados

Lista de feriados nacionais, estaduais e municipais brasileiros.

Endpoint Base feriados.apibrasil.pro Autenticação API Key (Bearer) Formato JSON Rate Limit 200 req/min

Endpoints

GET /feriados

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

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

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

GET /feriado/{data}

Verifica se uma data específica é feriado

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

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

GET /proximos-feriados

Lista os próximos feriados a partir da data atual

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

{
  "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 sua_api_key"

{
  "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"
  }
}