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

# Get holidays in a specific period

`GET /v1/workspaces/{workspaceId}/holidays/in-period`

## Path parameters

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

## Query parameters

- `assigned-to` string, required — Filter list of holidays assigned to user.
- `start` string, required — Filter list of holidays starting from start date. Expected date format yyyy-MM-ddThh:mm:ssZ
- `end` string, required — Filter list of holidays ending by end date. Expected date format yyyy-MM-ddThh:mm:ssZ

## 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.

## Changes

- **2026-08-20** `a5b636acbcd8` — 7 info
  - the `` response's property default value `` was added for the status `200`
  - the `` response's property default value `` was added for the status `200`
  - the `id` response's property default value `` was added for the status `200`
  - the `name` response's property default value `` was added for the status `200`
  - …3 more

[Change history](https://skmtc.dev/clockify/apis/clockify-api/changes/v1/workspaces/:workspaceId/holidays/in-period/get.md)

---

[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)