Sobre esta API

Calcule dias corridos, dias úteis, feriados, idade e muito mais entre duas datas. Suporte a feriados nacionais e estaduais. Funções disponíveis: contagem de dias entre duas datas (corridos, úteis, fins de semana, feriados), cálculo de dias úteis a partir de uma data, lista de feriados por ano/UF, dias restantes para o fim do ano, cálculo de idade em anos, meses e dias. Ideal para cálculos trabalhistas, escolares, planejamento, sistemas de gestão, recursos humanos e finanças.

Principais recursos

Dias corridos

Calcula a diferença total entre duas datas

Dias úteis

Exclui fins de semana e feriados

Feriados

Lista feriados nacionais e estaduais

Cálculo de idade

Idade em anos, meses e dias

Dias restantes

Dias restantes para o fim do ano

99.9% Uptime

Disponibilidade garantida

Feriados móveis

Carnaval, Páscoa, Corpus Christi

Feriados estaduais

Suporte a feriados estaduais (SP, RJ)

Documentação adicional

Feriados nacionais fixos (8): Confraternização Universal, Tiradentes, Dia do Trabalho, Independência, Nossa Senhora Aparecida, Finados, Proclamação da República, Natal. Feriados móveis: Carnaval, Sexta-feira Santa, Páscoa, Corpus Christi. Suporte a feriados estaduais (SP, RJ). Cálculo de idade em anos, meses e dias. Dias restantes para o fim do ano. Cache de 24 horas para dados imutáveis.

Informações técnicas

Endpoint dias.apibrasil.pro
Cache 24 horas
Preço Gratuito
Autenticação API Key (Bearer)
Formato JSON
Rate Limit 200 req/min
Limite Grátis 1,000 req/mês

Documentação

Endpoints da API Cálculo de Dias

Exemplos de requisições, parâmetros e respostas para cada endpoint.

GET /contar-dias

Calcula dias corridos, úteis, feriados e fins de semana entre duas datas

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`inicio`	string	✅ Sim	Data inicial (YYYY-MM-DD)
`fim`	string	✅ Sim	Data final (YYYY-MM-DD)
`incluir_feriados`	boolean	❌ Não	Incluir feriados no cálculo (true/false)

curl -X GET "https://dias.apibrasil.pro/contar-dias?inicio=2026-01-01&fim=2026-12-31&incluir_feriados=true" -H "Authorization: Bearer sk_live_dcaddc95473df193c89609c4f6b26d0d9748185b79aa4111"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Cálculo de Dias"
  }
}

GET /dias-uteis

Calcula quantos dias úteis a partir de uma data inicial

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`inicio`	string	✅ Sim	Data inicial (YYYY-MM-DD)
`dias`	number	✅ Sim	Número de dias úteis (1-365)
`incluir_feriados`	boolean	❌ Não	Considerar feriados (true/false)

curl -X GET "https://dias.apibrasil.pro/dias-uteis?inicio=2026-01-01&dias=30&incluir_feriados=true" -H "Authorization: Bearer sk_live_dcaddc95473df193c89609c4f6b26d0d9748185b79aa4111"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Cálculo de Dias"
  }
}

GET /feriados

Lista feriados de um ano específico

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`ano`	number	❌ Não	Ano (ex: 2026)
`uf`	string	❌ Não	UF para feriados estaduais (SP, RJ)

curl -X GET "https://dias.apibrasil.pro/feriados?ano=2026&uf=SP" -H "Authorization: Bearer sk_live_dcaddc95473df193c89609c4f6b26d0d9748185b79aa4111"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Cálculo de Dias"
  }
}

GET /dias-restantes

Calcula dias restantes até o fim do ano

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`data`	string	❌ Não	Data de referência (YYYY-MM-DD) - padrão: hoje

curl -X GET "https://dias.apibrasil.pro/dias-restantes?data=2026-07-14" -H "Authorization: Bearer sk_live_dcaddc95473df193c89609c4f6b26d0d9748185b79aa4111"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Cálculo de Dias"
  }
}

GET /idade

Calcula idade a partir da data de nascimento

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`nascimento`	string	✅ Sim	Data de nascimento (YYYY-MM-DD)
`data_referencia`	string	❌ Não	Data de referência (YYYY-MM-DD) - padrão: hoje

curl -X GET "https://dias.apibrasil.pro/idade?nascimento=1990-01-15" -H "Authorization: Bearer sk_live_dcaddc95473df193c89609c4f6b26d0d9748185b79aa4111"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Cálculo de Dias"
  }
}

GET /api/health

Health check da API

curl -X GET "https://dias.apibrasil.pro/api/health"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Cálculo de Dias"
  }
}

Pronto para começar?

Obtenha sua API Key e comece a integrar Cálculo de Dias hoje mesmo.

Acessar Dashboard Ver planos

Cálculo de Dias

Sobre esta API

Principais recursos

Dias corridos

Dias úteis

Feriados

Cálculo de idade

Dias restantes

99.9% Uptime

Feriados móveis

Feriados estaduais

Documentação adicional

Informações técnicas

Precisa de ajuda?

Teste a API Cálculo de Dias

Testar Cálculo de Dias

Endpoints da API Cálculo de Dias

Parâmetros

Parâmetros

Parâmetros

Parâmetros

Parâmetros

Pronto para começar?

Escolha o plano ideal para seu negócio

Precisa de um plano personalizado?