GET /v1/business-days

Calcula la fecha resultante de avanzar N días hábiles desde una fecha base. Los fines de semana (sábado y domingo) y los feriados venezolanos de tipo Public no cuentan como días hábiles.

Útil para SLAs ("respondemos en 5 días hábiles"), liquidación de pagos, plazos legales y promesas de entrega.

Disponible desde el plan Starter. El plan Free no tiene acceso a las utilities venezolanas.

Request

GET /v1/business-days?from=2026-05-10&days=10 HTTP/1.1
Host: api.cotizave.com
X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d

Query parameters

Parámetro	Tipo	Requerido	Default	Descripción
`from`	string (YYYY-MM-DD)	No	hoy (UTC)	Fecha base.
`days`	integer	Sí	—	Días hábiles a avanzar (0–3650).

cURL

# Avanzar 10 días hábiles desde el 10 de mayo
curl "https://api.cotizave.com/v1/business-days?from=2026-05-10&days=10" \
  -H "X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d"

# Avanzar 5 días hábiles desde hoy
curl "https://api.cotizave.com/v1/business-days?days=5" \
  -H "X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d"

Response

200 OK

{
  "from": "2026-05-10",
  "days": 10,
  "result": "2026-05-25"
}

Schema

Campo	Tipo	Descripción
`from`	string	Fecha base de la consulta.
`days`	integer	Días hábiles avanzados.
`result`	string (YYYY-MM-DD)	Fecha resultante después de avanzar `days` días hábiles desde `from`.

Notas

Solo se excluyen feriados de tipo Public (nacionales). Los feriados Bank y Observance sí cuentan como días hábiles.
El día base (from) NO se cuenta — el conteo arranca desde el siguiente día calendario.
Si days = 0, devuelve la misma fecha base sin avanzar.

Errores posibles

HTTP	code	Causa
`400`	`missing_field`	Falta `days` o es negativo.
`400`	`invalid_format`	`days` > 3650 o `from` mal formada.
`401`	`unauthorized`	API Key inválida, faltante o revocada.
`429`	`rate_limit_exceeded`	Cuota mensual agotada.
`503`	`holidays_unavailable`	Datos de feriados temporalmente no disponibles.

Header X-Data-Source: normadata.io. Datos junto a normadata.io.

← AnteriorPróximo feriado