> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cotizave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API de feriados por país y fecha

> Comprueba un feriado con GET /v2/holidays/{CC}?date=YYYY-MM-DD; revisa los permisos y la respuesta del calendario.

## Comprobar una fecha

```bash curl theme={null}
curl "https://api.cotizave.com/v2/holidays/CO?date=2026-01-01" \
  -H "X-API-Key: $COTIZAVE_API_KEY"
```

Respuesta ilustrativa; cifras y fechas de ejemplo.

```json theme={null}
{
  "country": "CO",
  "date": "2026-01-01",
  "is_holiday": true,
  "holiday": {
    "date": "2026-01-01",
    "local_name": "Año Nuevo",
    "name": "New Year",
    "type": "Public",
    "types": [
      "Public"
    ],
    "fixed": true,
    "global": true
  }
}
```

## Listar un año

```bash curl theme={null}
curl "https://api.cotizave.com/v2/holidays/CO?year=2026" \
  -H "X-API-Key: $COTIZAVE_API_KEY"
```

Fragmento ilustrativo de `holidays`; la respuesta real incluye todos los feriados publicados del año:

```json theme={null}
{
  "country": "CO",
  "year": 2026,
  "holidays": [
    { "date": "2026-01-01", "local_name": "Año Nuevo", "name": "New Year", "type": "Public", "types": ["Public"], "fixed": true, "global": true }
  ]
}
```

## Próximo feriado

```bash curl theme={null}
curl "https://api.cotizave.com/v2/holidays/CO?from=2026-12-31" \
  -H "X-API-Key: $COTIZAVE_API_KEY"
```

```json theme={null}
{
  "country": "CO",
  "from": "2026-12-31",
  "days_until": 1,
  "holiday": { "date": "2027-01-01", "local_name": "Año Nuevo", "name": "New Year", "type": "Public", "types": ["Public"], "fixed": true, "global": true }
}
```

Usa solo uno de `year`, `date` o `from`. Un país sin calendario publicado devuelve `404 holidays_not_available`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.