> ## 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.

# Country holiday lookup by date API

> Check a holiday with GET /v2/holidays/{CC}?date=YYYY-MM-DD, including access requirements and calendar response.

## Check a date

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

Illustrative response; sample figures and dates.

```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
  }
}
```

## List a year

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

Illustrative excerpt of `holidays`; the actual response includes all published holidays for the year:

```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 }
  ]
}
```

## Next holiday

```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 }
}
```

Use only one of `year`, `date`, or `from`. A country without a published calendar returns `404 holidays_not_available`.


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