GET /v1/holidays/next
Devuelve el próximo feriado venezolano a partir de una fecha base, junto con cuántos días faltan. Útil para mostrar "faltan 3 días para el próximo feriado" o para planificar cierres operativos.
Disponible desde el plan Starter. El plan Free no tiene acceso a las utilities venezolanas.
Request
GET /v1/holidays/next?from=2026-05-10 HTTP/1.1
Host: api.cotizave.com
X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3dQuery parameters
| Parámetro | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
from | string (YYYY-MM-DD) | No | hoy (UTC) | Fecha base. El resultado es el primer feriado posterior a esta fecha. |
cURL
curl "https://api.cotizave.com/v1/holidays/next?from=2026-05-10" \
-H "X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d"Response
200 OK
{
"from": "2026-05-10",
"date": "2026-06-24",
"local_name": "Batalla de Carabobo",
"name": "Battle of Carabobo Day",
"type": "Public",
"types": ["Public"],
"fixed": true,
"days_until": 45
}Schema
| Campo | Tipo | Descripción |
|---|---|---|
from | string | Fecha base usada en la consulta. |
date | string | Fecha del próximo feriado. |
days_until | integer | Días entre from y date. |
local_name / name / type / types / fixed | — | Mismo shape que cada item en /v1/holidays. |
Errores posibles
| HTTP | code | Causa |
|---|---|---|
400 | invalid_format | from no es YYYY-MM-DD válido. |
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.