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

# Holidays

> List the holidays of the workspace.

A holiday blocks bookings for the whole day, unless a host's availability has a date override for it. A recurring holiday repeats every year on the same date. Holidays can be read here and managed in the NeetoCal app. For fields and response details, see the [API reference](/api/holidays/list). Sample output on this page uses `--json`.

## List holidays

This command lists the holidays of the workspace. Use this when you want to know why nobody can be booked on a date, or to check a date range before booking.

```bash theme={"system"}
neetocal holidays list
neetocal holidays list --from-date 2026-10-01 --to-date 2026-10-31
neetocal holidays list --search offsite --include-disabled
```

| Flag | Type | Required | Default | Description |
| - | - | - | - | - |
| `--from-date` | `string` | | | Only holidays on or after this date (YYYY-MM-DD); recurring holidays are always included |
| `--include-disabled` | `bool` | | `false` | Include holidays that are turned off |
| `--page` | `int` | | `0` | Page number |
| `--page-size` | `int` | | `0` | Items per page (max 100) |
| `--search` | `string` | | | Only holidays whose name contains this text |
| `--to-date` | `string` | | | Only holidays on or before this date (YYYY-MM-DD) |

```json Sample output (--json) theme={"system"}
{
  "data": [
    {
      "id": "3f1c8a52-6a58-4a5c-9d57-2f5d0a6f3c11",
      "name": "Company offsite",
      "kind": "day",
      "holiday_on": "2026-10-19",
      "start_date": null,
      "end_date": null,
      "is_recurring": false,
      "enabled": true
    }
  ],
  "pagination": { "total_records": 1, "total_pages": 1, "current_page_number": 1, "page_size": 15 }
}
```

`kind` is `day` for a single date in `holiday_on`, or `range` for the dates from `start_date` to `end_date`. When you pass `--from-date` or `--to-date`, recurring holidays are always included.

To see how a holiday affects the open times of a meeting, run [`neetocal meetings unavailable-slots`](/cli-reference/meetings#list-unavailable-slots).


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