Cálculo de Dias

Calcule dias corridos, úteis, feriados e idade entre datas.

Endpoint Base dias.apibrasil.pro Autenticação API Key (Bearer) Formato JSON Rate Limit 200 req/min

Endpoints

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)

Exemplo de Requisição

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

Exemplo de Resposta

{
  "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)

Exemplo de Requisição

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

Exemplo de Resposta

{
  "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)

Exemplo de Requisição

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

Exemplo de Resposta

{
  "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

Exemplo de Requisição

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

Exemplo de Resposta

{
  "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

Exemplo de Requisição

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

Exemplo de Resposta

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

Health check da API

Exemplo de Requisição

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

Exemplo de Resposta

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