HolidayDB
API de feriados
Dados globais de feriados públicos e recessos para RH, folha de pagamento e compliance.
Dados nacionais e regionais atualizados por uma API simples. Pare de codificar calendários manualmente e de manter regras de feriados na mão.
Exemplo de requisição
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.holidaydb.com/api/holidays?country=US"Exemplo de resposta
[
{
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"country_code": "US",
"religion_slug": null,
"type": "public_holiday",
"scope": "national",
"region_codes": [],
"region_names": [],
"start_date": "2026-07-04",
"end_date": "2026-07-04",
"provisional": false,
"substitute": false,
"summary": "Independence Day",
"language": "en"
}
// ... mais objetos de feriado na resposta completa (ver /pt/documentacao#get-holidays)
]Feito para sistemas sérios
A HolidayDB foi pensada para:
Plataformas de RH
Mantenha cadastros e regras de ausências alinhados a feriados oficiais e datas de férias.
Software de folha de pagamento
Calcule pagamento de feriados, férias e horas extras com datas corretas.
Sistemas de gestão de licenças
Valide pedidos de ausência contra feriados públicos, férias e regras regionais.
Ferramentas de ponto e apontamento
Marque feriados e férias automaticamente para manter o timesheet em conformidade.
ERPs
Orquestre fluxos e aprovações a partir de uma única fonte de verdade sobre feriados.
Produtos SaaS em expansão internacional
Adicione países sem manter lógica de feriados e férias mercado a mercado.
Quando feriados e férias impactam pagamento, saldo de licenças ou conformidade, a precisão não é negociável.
O que você recebe
Feriados públicos nacionais
Calendários regionais cobrindo 231 países. Datas de âmbito nacional para cada um.
Feriados por subdivisão
Estados, províncias e regiões: 4.788 subdivisões ISO 3166-2 no CountriesDB para 195 de 231 países com feriados.
Calendários religiosos
Cristão, islâmico, judaico, hindu, cristianismo ortodoxo. religion_slug estável para filtros.
Suporte a vários idiomas
Nomes de feriados no idioma que você precisa (plano Full).
Atualizado diariamente
Incluindo datas que ainda podem mudar, para você permanecer preciso.
API REST limpa
Endpoints simples, respostas JSON, filtros por país, religião e data.
Estrutura de dados confiável
Campos e tipos consistentes para integração fácil.
Plano gratuito (padrão)
Teste a integração antes de ir a produção, sem custo extra.
Por que não usar uma lista estática de feriados ou férias?
Dados copiados ou hardcoded criam risco oculto:
- Datas de feriados e férias mudam e são atualizadas diariamente
- Feriados por subdivisão variam por região
- Datas observadas mudam; algumas ainda podem ser alteradas
- A manutenção vira manual e propensa a erros
- Erros de folha de pagamento custam caro
A HolidayDB elimina esse risco.
Exemplos de requisições à API
Devolve todos os feriados públicos de um país. A resposta inclui uuid, datas, type, scope, summary, region_names e language.
Parâmetros
countryConsulta: código de país de duas letras (ISO 3166-1 alpha-2), ex.: US, DE.AuthorizationCabeçalho: Bearer YOUR_API_KEY (obrigatório em todas as requisições).
GET /api/holidays?country=US
Authorization: Bearer YOUR_API_KEY
[
{
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"country_code": "US",
"religion_slug": null,
"type": "public_holiday",
"scope": "national",
"region_codes": [],
"region_names": [],
"start_date": "2026-07-04",
"end_date": "2026-07-04",
"provisional": false,
"substitute": false,
"summary": "Independence Day",
"language": "en"
}
]Planos de produção
Todos os planos incluem: acesso à API, autenticação segura, endpoints versionados, documentação e suporte por e-mail.
Grátis
Planos pagos
Basic
Pro
Full
Pensado para crescimento internacional
Expandindo para novos países? A HolidayDB ajuda você a:
- Entrar em novos mercados mais rápido
- Evitar erros de conformidade
- Reduzir esforço de engenharia
- Manter a lógica de feriados e férias consistente entre regiões
Perguntas frequentes
- Com que frequência os dados são atualizados?
- Os dados são conferidos e atualizados diariamente, inclusive datas que ainda podem mudar, para você ter sempre as informações mais recentes de feriados e férias.
- Há suporte a feriados por subdivisão?
- Sim. Feriados por subdivisão cobrem estados, províncias e regiões: 4.788 subdivisões ISO 3166-2 em 231 países com feriados.
- Posso usar a HolidayDB em sistemas de folha de pagamento?
- Sim. A HolidayDB foi construída especificamente para integrações de RH e folha.
- Existe teste gratuito?
- Sim. Toda conta começa no plano Free, para você testar a integração antes de subir de plano para produção.