API reference
Holidays
4 endpoints. Click one to see its parameters, fields and an example. Code samples use the region you pick.
GET/v1/holidaysHolidays for a year: the workspace's, a location's, or mine
Holidays for a year: the workspace's, a location's, or mine
Query parameters
| Name | Type | Description |
|---|---|---|
year | integer | |
from | string | |
to | string | |
location_id | string | |
mine | boolean |
Example
curl "https://ca-api.clocklap.com/v1/holidays" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY"Responses
200
GET/v1/holidays/calendarsHoliday calendars you can choose from
Holiday calendars you can choose from
Example
curl "https://ca-api.clocklap.com/v1/holidays/calendars" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY"Responses
200
POST/v1/holidays/customAdd a company holiday, or remove a calendar day you don't give
Add a company holiday, or remove a calendar day you don't give
Body (JSON)
| Name | Type | Description |
|---|---|---|
daterequired | string | |
name | string | |
kind | "add" | "remove" | |
location_id | string or null |
Example
curl -X POST "https://ca-api.clocklap.com/v1/holidays/custom" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-10-26","name":"Example","kind":"add","location_id":"loc_01J…"}'Responses
200
DELETE/v1/holidays/custom/{id}Delete one custom
Delete one custom
Path parameters
| Name | Type | Description |
|---|---|---|
idrequired | string |
Example
curl -X DELETE "https://ca-api.clocklap.com/v1/holidays/custom/{id}" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY"Responses
200