---
title: "Get holidays on a workspace"
method: GET
path: "/v1/workspaces/{workspaceId}/holidays"
tags: ["Holiday"]
---

# Get holidays on a workspace

`GET /v1/workspaces/{workspaceId}/holidays`

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.

## Query parameters

- `assigned-to` string — If provided, you'll get a filtered list of holidays assigned to user.

## Response `200`

OK

- HolidayDtoV1[]
  - `automaticTimeEntryCreation` boolean — Indicates that time entries will be automatically created for this holiday.
  - `datePeriod` DatePeriod — Represents startDate and endDate of the holiday. Date is in format yyyy-mm-dd
    - `endDate` string, date
    - `startDate` string, date
  - `everyoneIncludingNew` boolean — Indicates whether the holiday is shown to new users.
  - `id` string — Represents holiday identifier across the system.
  - `name` string — Represents the name of the holiday.
  - `occursAnnually` boolean — Indicates whether the holiday occurs annually.
  - `projectId` string — Represents projectId for automatic time entry creation.
  - `taskId` string — Represents taskId for automatic time entry creation.
  - `userGroupIds` string[] — Indicates which user groups are included.
  - `userIds` string[] — Indicates which users are included.
  - `workspaceId` string — Represents workspace identifier across the system.

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)