curl --request GET \
--url https://{your-subdomain}.neetocal.com/api/external/v2/holidays \
--header 'X-Api-Key: <x-api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};
fetch('https://{your-subdomain}.neetocal.com/api/external/v2/holidays', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{your-subdomain}.neetocal.com/api/external/v2/holidays"
headers = {"X-Api-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"holidays": [
{
"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
}
}{
"error": "from_date must be on or before to_date."
}List holidays
List the holidays of the workspace. On a holiday no host can be booked for the whole day, unless the host’s availability has a date override for it. A recurring holiday repeats every year on the same date.
Any API key and any signed-in member can read holidays. Holidays can only be managed in the NeetoCal app.
curl --request GET \
--url https://{your-subdomain}.neetocal.com/api/external/v2/holidays \
--header 'X-Api-Key: <x-api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};
fetch('https://{your-subdomain}.neetocal.com/api/external/v2/holidays', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{your-subdomain}.neetocal.com/api/external/v2/holidays"
headers = {"X-Api-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"holidays": [
{
"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
}
}{
"error": "from_date must be on or before to_date."
}{your-subdomain} with your workspace’s subdomain. Learn how to find your subdomain in Workspace subdomain.
Headers
Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.
Query Parameters
Only holidays whose name contains this text.
"offsite"
Only holidays on or after this date (YYYY-MM-DD). Recurring holidays are always included.
"2026-10-01"
Only holidays on or before this date (YYYY-MM-DD). Recurring holidays are always included.
"2026-10-31"
Set to true to include holidays that are turned off.
Page of results to retrieve, starting from 1. Defaults to 1 when omitted.
Number of results per page, up to 100. Defaults to 15 when omitted.
x <= 100Response
OK - Request succeeded
Hide child attributes
Hide child attributes
Unique identifier for the holiday.
"3f1c8a52-6a58-4a5c-9d57-2f5d0a6f3c11"
Name of the holiday.
"Company offsite"
day uses holiday_on. range uses start_date and end_date.
day, range "day"
Date of the holiday when kind is day.
"2026-10-19"
First day of the holiday when kind is range.
null
Last day of the holiday when kind is range.
null
Whether the holiday repeats on the same month and day every year.
false
Whether the holiday is turned on. A holiday that is turned off does not block bookings.
true