POST AI agent ready /v1/holidays/list

API de feriados - lista de feriados por país e ano

Retorna todos os feriados de um país e ano especificados. Cada feriado inclui a data, nome em inglês, nome local e tipos (Público, Bancário, Nacional, etc.). Suporta mais de 100 países com códigos de país ISO 3166-1 alfa-2.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/holidays/list \
  -H "Content-Type: application/json" \
  -d '{"country":"US","year":2026}'

When to use this API

Estimativa da data de entrega

Ao calcular as datas estimadas de entrega para um pedido de comércio eletrônico, exclua os feriados da contagem de dias úteis. Busque a lista de feriados do país de destino e pule essas datas na sua aritmética de datas.

Agendamento de funcionários e folha de pagamento

Sinalize automaticamente feriados em seu sistema de agendamento. Calcule as taxas de pagamento de feriados, evite que os gerentes agendem turnos que se sobreponham aos feriados legais e gere relatórios precisos da folha de pagamento.

Integrações de calendário

Preencher previamente aplicativos de calendário com feriados do país do usuário. Exiba feriados junto com eventos pessoais e reuniões de trabalho para que os usuários possam planejar dias de folga sem adicionar manualmente cada feriado.

Frequently asked questions

Quantos países são suportados?

Mais de 100 países são suportados usando códigos ISO 3166-1 alfa-2. Grandes países como EUA, GB, DE, FR, JP, BR, IN, AU e CA têm cobertura completa para férias.

Os feriados regionais ou estaduais estão incluídos?

A resposta centra-se nos feriados nacionais. Feriados regionais ou específicos de cada estado (como feriados estaduais dos EUA) não estão incluídos na lista padrão.

O que a matriz de tipos contém?

A matriz de tipos classifica cada feriado. Os valores comuns incluem "Público" (dia de folga reconhecido pelo governo), "Banco" (feriado bancário), "Nacional" (observância nacional) e "Opcional" (opcional ou apenas para observância). Um feriado pode ter vários tipos.

Posso consultar feriados de anos anteriores?

Sim. Você pode consultar feriados de qualquer ano de 2000 a 2100. Os dados históricos são úteis para auditar cálculos anteriores da folha de pagamento ou verificar contagens de dias úteis em períodos anteriores.

O que acontece se eu omitir o parâmetro ano?

O ponto final é padronizado para o ano civil atual. Se precisar de férias para o próximo ano (por exemplo, para planejamento), passe o ano explicitamente.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.