GET /v1/holidays/check

Verifica si una fecha dada es feriado venezolano. Si lo es, devuelve los detalles del feriado (nombre, tipo, si es móvil).

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

Request

GET /v1/holidays/check?date=2026-12-25 HTTP/1.1
Host: api.cotizave.com
X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d

Query parameters

Parámetro	Tipo	Requerido	Descripción
`date`	string (YYYY-MM-DD)	Sí	Fecha a verificar.

cURL

curl "https://api.cotizave.com/v1/holidays/check?date=2026-12-25" \
  -H "X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d"

Response

200 OK — es feriado

{
  "date": "2026-12-25",
  "is_holiday": true,
  "local_name": "Navidad",
  "name": "Christmas Day",
  "type": "Public",
  "types": ["Public"],
  "fixed": true
}

200 OK — no es feriado

{
  "date": "2026-05-12",
  "is_holiday": false
}

Errores posibles

HTTP	code	Causa
`400`	`missing_field`	El parámetro `date` es obligatorio.
`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.

← AnteriorFeriados del año Siguiente →Próximo feriado