GET /v1/holidays
Devuelve todos los feriados venezolanos del año solicitado, incluidos los fijos (Año Nuevo, Navidad), los móviles (Carnaval, Semana Santa) y los bancarios. Cada item incluye la fecha, nombre local en español, tipo y si aplica nacionalmente.
Disponible desde el plan Starter. El plan Free no tiene acceso a las utilities venezolanas.
Request
GET /v1/holidays?year=2026 HTTP/1.1
Host: api.cotizave.com
X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3dQuery parameters
| Parámetro | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
year | integer | No | año actual (UTC) | Año a consultar (1583–9999). |
cURL
curl "https://api.cotizave.com/v1/holidays?year=2026" \
-H "X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d"Response
200 OK
{
"year": 2026,
"country": "VE",
"holidays": [
{
"date": "2026-01-01",
"local_name": "Año Nuevo",
"name": "New Year's Day",
"type": "Public",
"types": ["Public"],
"fixed": true,
"global": true
},
{
"date": "2026-04-02",
"local_name": "Jueves Santo",
"name": "Maundy Thursday",
"type": "Public",
"types": ["Public"],
"fixed": false,
"global": true
}
]
}Schema
| Campo | Tipo | Descripción |
|---|---|---|
year | integer | Año consultado. |
country | string | Siempre VE. |
holidays[].date | string (YYYY-MM-DD) | Fecha del feriado. |
holidays[].local_name | string | Nombre en español (ej: Día del Trabajador). |
holidays[].name | string | Nombre en inglés. |
holidays[].type | string | Tipo primario: Public, Bank, Observance. |
holidays[].types | string[] (omitempty) | Lista completa cuando un feriado tiene múltiples categorías. |
holidays[].fixed | boolean | false = feriado móvil (Carnaval, Semana Santa). |
holidays[].global | boolean | true si aplica a todo el país. |
Errores posibles
| HTTP | code | Causa |
|---|---|---|
400 | invalid_format | year fuera del rango 1583–9999. |
401 | unauthorized | API Key inválida, faltante o revocada. |
429 | rate_limit_exceeded | Cuota mensual agotada o ráfaga excedida. |
503 | holidays_unavailable | Datos de feriados temporalmente no disponibles. Reintentar en unos segundos. |
Atribución
Header X-Data-Source: normadata.io. Calendario mantenido junto a normadata.io.