.svg?fit=max&auto=format&n=9voKLLkajreclhp4&q=85&s=321632804eda4b3cff044941f9ccadda)
API Reference
- GETGet All Availability Schedules
- GETGet Default Availability Schedule
- PATCHUpdate Default Availability Schedule
- GETGet Availability Schedule by UUID
- PATCHUpdate Availability Schedule by UUID
- GETList Time-Off Periods
- POSTCreate Time-Off Periods
- PATCHUpdate Time-Off Period
- DELDelete Time-Off Period
- GETList Holiday Categories
- GETPreview Holidays for a Category
- GETList Holiday Subscriptions
- POSTCreate Holiday Subscriptions
- DELDelete a Holiday Subscription
- PUTToggle Holiday Overrides
Preview Holidays for a Category
Returns the holidays that would block a user’s availability if they subscribed to a given category.
Use this before calling POST /holidays/subscriptions to show the user exactly which dates will be marked unavailable, and to let them pick excludedHolidayKeys.
When year is omitted, the response contains the next occurrence of each holiday across a multi-year window — nextDate carries that future date and may differ from date. When year is supplied, only that calendar year is returned and nextDate is omitted (it would be identical to date).
curl --request GET \
--url https://api.zeeg.me/v2/holidays/preview \
--header 'Authorization: Bearer <token>'{
"collection": [
{
"key": "new-year",
"name": "New Year's Day",
"date": "2026-01-01",
"nextDate": "2027-01-01"
},
{
"key": "christmas-day",
"name": "Christmas Day",
"date": "2026-12-25",
"nextDate": "2027-12-25"
}
]
}Authorizations
Query Parameters
Country or region key from /holidays/categories (e.g. DE, DE-BY).
30"DE"
Restrict the preview to a single calendar year. Omit for a multi-year preview that surfaces each holiday's next occurrence.
2000 <= x <= 21002026
Response
OK
Holidays that fall in the requested category.
Hide child attributes
Hide child attributes
curl --request GET \
--url https://api.zeeg.me/v2/holidays/preview \
--header 'Authorization: Bearer <token>'{
"collection": [
{
"key": "new-year",
"name": "New Year's Day",
"date": "2026-01-01",
"nextDate": "2027-01-01"
},
{
"key": "christmas-day",
"name": "Christmas Day",
"date": "2026-12-25",
"nextDate": "2027-12-25"
}
]
}