---
search:
  tags:
    - holidays
    - GET
seo:
  description: >-
    Retrieves the workspace holiday configuration, including the default
    holiday… Reference for the GET /holidays/settings endpoint in the Leadtime
    Public API API.
sidebar:
  badge: GET
  label: Get holiday settings
title: Get holiday settings
type: openapi-operation
---
Retrieves the workspace holiday configuration, including the default holiday country/region and all available holiday sources.

**What are Holiday Settings?**
Holiday settings determine which regional holiday rules the system uses for capacity planning. Leadtime needs to know when employees are not available due to regional holidays, which is essential for accurate capacity management.

**What is returned:**
- `defaultHolidayCode`: The default holiday country/region code for the workspace (e.g., "US", "DE", "US-CA")
- `availableCountries`: List of all available holiday countries and states with their codes and localized names

**How it works:**
- The default holiday code is automatically applied to all new employees
- Individual employees can have different holiday rules set in their profile
- Holidays are displayed in the team calendar and used for capacity calculations
- Use the `language` query parameter to get country names in a specific language (default: "en")

**Note:** This endpoint requires the `manageSettings` permission.

<Operation source="api-reference" id="holidayscontroller-getholidaysettings" />