Pular para o conteúdo principal

​
Endpoint

POST https://api.bunny.build/api/v1/public-holidays

​
Autenticação

HeaderObrigatórioValor
X-API-KeySimSua chave de API (bun_...)
Content-TypeSimapplication/json

​
Visão geral

Recupere uma lista completa de feriados nacionais para qualquer país suportado, com filtro opcional por ano. Retorna os nomes dos feriados no idioma local junto com datas ISO, permitindo agendamentos conscientes de datas, cálculos de SLA e integrações com calendários.

​
Casos de uso

  • Ignorar feriados em cálculos de dias úteis
  • Exibir feriados regionais em interfaces de agendamento ou calendário
  • Automatizar ajustes de prazo de SLA em torno de feriados nacionais
  • Construir sistemas de folha de pagamento ou controle de ponto conscientes de países

​
Detalhes

Cobre mais de 100 países. Os dados de feriados incluem observâncias nacionais e regionais. O campo year tem como padrão o ano atual quando omitido. Os códigos de país seguem o padrão ISO 3166-1 alpha-2 (ex.: BR, US, DE).

​
Corpo da requisição

CampoTipoObrigatórioDescrição
countrystringSimCódigo de país ISO 3166-1 alpha-2 (ex.: BR, US)
yearnumberNãoAno para buscar os feriados (padrão: ano atual)

​
Exemplo

{
  "country": "BR",
  "year": 2025
}

​
Resposta

​
200 OK

CampoTipoDescrição
countrystringCódigo de país ISO
yearnumberAno dos feriados
holidaysobject[]Array de objetos de feriado
Cada objeto de feriado:
CampoTipoDescrição
datestringData ISO 8601 (YYYY-MM-DD)
namestringNome do feriado no idioma local
typestringnational, regional ou observance
Exemplo 
{
  "country": "BR",
  "year": 2025,
  "holidays": [
    { "date": "2025-01-01", "name": "Confraternização Universal", "type": "national" },
    { "date": "2025-04-21", "name": "Tiradentes", "type": "national" },
    { "date": "2025-09-07", "name": "Independência do Brasil", "type": "national" }
  ]
}

​
401 Unauthorized

{
  "detail": "Missing API key. Include X-API-Key header."
}

​
402 Payment Required

{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}

​
422 Unprocessable Entity

{
  "detail": "Unknown country code"
}

​
429 Too Many Requests

{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

​
Exemplo cURL

curl -X POST https://api.bunny.build/api/v1/public-holidays \
  -H "X-API-Key: bun_sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{"country": "BR", "year": 2025}'