Preview Holidays for a Category - Zeeg Developer Hub

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"
    }
  ]
}

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

collection

object[]

required

Holidays that fall in the requested category.

Hide child attributes

collection.key

string

required

Stable holiday identifier (e.g. christmas-day).

collection.name

string

required

collection.date

string<date>

required

Holiday date.

collection.nextDate

string<date>

Next future occurrence of this holiday. Present only on multi-year previews where it differs from date.

Last modified on April 29, 2026

List Holiday Categories

List Holiday Subscriptions

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"
    }
  ]
}