Get available holiday countries

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.

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

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

import requests

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

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