---
search:
  tags:
    - holidays
    - GET
seo:
  description: >-
    Retrieves the complete list of available holiday countries and states that…
    Reference for the GET /holidays/countries endpoint in the Leadtime Public
    API API.
sidebar:
  badge: GET
  label: Get available holiday countries
title: Get available holiday countries
type: openapi-operation
---
Retrieves the complete list of available holiday countries and states that can be used for holiday configurations.

**What is returned:**
- List of all supported holiday regions with:
  - `code`: Country/region code (e.g., "US", "DE", "US-CA", "AT")
  - `name`: Localized country/region name (e.g., "United States", "Germany", "California", "Austria")

**How to use:**
- Use these codes when setting default holiday settings or individual employee holiday rules
- Country codes follow ISO 3166-1 alpha-2 format (e.g., "US", "DE")
- State codes use format "COUNTRY-STATE" (e.g., "US-CA" for California, "US-NY" for New York)
- Use the `language` query parameter to get country names in a specific language (default: "en")

**Note:** This list includes all regions for which Leadtime has official holiday data. Holidays are automatically loaded from official sources for these regions.

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