Skip to main content
GET
/
holidays
/
preview
Preview holidays for a category
curl --request GET \
  --url https://api.zeeg.me/v2/holidays/preview \
  --header 'Authorization: Bearer <token>'
{
  "collection": [
    {
      "key": "new-year",
      "name": "New Year's Day",
      "date": "2026-01-01",
      "nextDate": "2027-01-01"
    },
    {
      "key": "christmas-day",
      "name": "Christmas Day",
      "date": "2026-12-25",
      "nextDate": "2027-12-25"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developer.zeeg.me/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Query Parameters

​
categoryKey
string
required

Country or region key from /holidays/categories (e.g. DE, DE-BY).

Maximum string length: 30
Example:

"DE"

​
year
integer

Restrict the preview to a single calendar year. Omit for a multi-year preview that surfaces each holiday's next occurrence.

Required range: 2000 <= x <= 2100
Example:

2026

Response

OK

​
collection
object[]
required

Holidays that fall in the requested category.

Last modified on April 29, 2026