Get holiday settings

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.

curl -X GET "https://leadtime.app/api/public/holidays/settings?language=string" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/holidays/settings?language=string", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/holidays/settings?language=string",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

{
  "availableCountries": [
    {
      "code": "US",
      "name": "United States"
    }
  ],
  "defaultHolidayCode": "US"
}