Workspace configuration
List business holidays
Lists the public holidays and closed days the business observes, with any shortened opening hours. Filter by year, which defaults to the current year.
Requires: desk.read scope, Converse licence.
Authorization
bearerAuth AuthorizationBearer <token>
A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.
In: header
Query Parameters
year?integer
The year to list, such as 2026. Defaults to the current year.
cursor?string
next_cursor from the previous page. Leave it out for the first page.
limit?integer
Page size: 100 by default, 100 at most.
Response
OK
Example
{ "data": [ { "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37", "date": "2026-10-14T08:30:00Z", "name": "Amina Wanjiru", "opens": "example", "closes": "example" } ], "next_cursor": "eyJvIjoyNX0", "has_more": false}FieldTypeDescription
datarequiredobject[]idrequiredstring (uuid)daterequiredstringThe date, as YYYY-MM-DD.namerequiredstringA name for it.opensstringThe time the business opens on that day, in 24-hour HH:MM.closesstringThe time the business closes on that day, in 24-hour HH:MM. Leave out both opens and closes for a day when you are closed.next_cursorrequiredstring | nullhas_morerequiredbooleancurl -X GET "https://api.sautidesk.com/v1/desk/holidays"