API v1 — 5.570 municípios cobertos
Feriados brasileiros em uma chamada de API
Nacionais, estaduais e municipais. P95 sob 30 ms. Datas móveis (Páscoa, Carnaval, Corpus Christi) calculadas em tempo real.
Três passos até a primeira chamada
Do registro à integração em menos de cinco minutos.
1
Crie sua conta
Registro grátis. Requisições ilimitadas, sem cota mensal.
2
Gere um token
Escolha ambiente (test ou live), restrinja por domínio ou IP.
3
Faça a primeira chamada
Uma linha de curl, JSON na próxima resposta. Sem SDK obrigatório.
Use sua linguagem
curl https://api.prod.holibras.com.br/v1/holidays?year=2026&uf=SP \
-H 'Authorization: Bearer fk_live_…'Por que Holibras
Comparado às APIs públicas mais populares de feriados brasileiros.
| Holibras | Outras | |
|---|---|---|
| Cobertura municipal completa (5.570 cidades) | ||
| Datas móveis calculadas em runtime | ||
| Painel de administração com auditoria | ||
| Requisições ilimitadas, sem cota mensal | ||
| p95 < 30ms | ||
| OpenAPI 3.1 oficial |
Perguntas frequentes
- Os feriados municipais cobrem todos os 5.570 municípios?
- Sim. A base é importada do IBGE e curada por scope (NATIONAL, STATE, MUNICIPAL).
- Vocês suportam datas móveis?
- Sim. Páscoa, Carnaval, Sexta-feira Santa, Corpus Christi e outras movables são computadas no servidor via algoritmo de Meeus.
- Posso limitar um token por domínio ou IP?
- Sim. Cada token aceita allowlists de domínio (Origin) e CIDR. Quando ambos estão definidos, ambos precisam casar.
- Existe limite de chamadas?
- Não há cota mensal. O único limite é o rate limit de 20 req/s por token — se exceder, vem 429 com Retry-After.
- Tem SDK?
- Não — a API é tão simples que um curl resolve. O playground gera snippets em curl, JS, Python, PHP e Go.