Holidays

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

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	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)

Sample output (--json)

{
  "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.

Getting started

Commands

List holidays

​List holidays

List holidays