Availability Schedule

List Holiday Subscriptions

Returns the holiday subscriptions for the specified user. Each subscription expands into a holidays[] list of cached occurrences with an excluded flag indicating whether that holiday is currently overridden off for this user.

For a country subscription only category: {type, key, name} is returned. For a region subscription, an additional country: {key, name} block disambiguates the parent country (e.g. category.key = DE-BY and country.key = DE).

GET

/

holidays

/

subscriptions

List holiday subscriptions

curl --request GET \
  --url https://api.zeeg.me/v2/holidays/subscriptions \
  --header 'Authorization: Bearer <token>'

{
  "collection": [
    {
      "uuid": 42,
      "uri": "https://api.zeeg.me/v2/holidays/subscriptions/42",
      "category": {
        "type": "country",
        "key": "DE",
        "name": "Germany"
      },
      "holidays": [
        {
          "key": "new-year",
          "name": "New Year's Day",
          "date": "2026-01-01",
          "nextDate": "2027-01-01",
          "excluded": false
        },
        {
          "key": "christmas-day",
          "name": "Christmas Day",
          "date": "2026-12-25",
          "nextDate": "2027-12-25",
          "excluded": true
        }
      ],
      "createdAt": "2026-04-01T09:12:33+00:00",
      "updatedAt": "2026-04-15T08:00:00+00:00"
    }
  ]
}

Authorizations

Authorization

string

header

required

Query Parameters

email

string<email>

required

Email address of the user whose holiday subscriptions to retrieve.

Example:

"lena.meier@horizondigital.de"

Response

OK

collection

object[]

required

Holiday subscriptions for the user.

Hide child attributes

collection.uuid

integer<int64>

required

Subscription identifier.

collection.uri

string<uri>

required

Self-link to delete this subscription or toggle its overrides.

Example:

"https://api.zeeg.me/v2/holidays/subscriptions/42"

collection.category

object

required

Hide child attributes

collection.category.type

enum<string>

required

Available options:

country,

region

collection.category.key

string

required

Country or region key (e.g. DE, DE-BY).

collection.category.name

string | null

required

collection.country

object

Parent country. Present only when category.type is region; omitted for country subscriptions to avoid duplicating category.

Hide child attributes

collection.country.key

string

required

collection.country.name

string | null

required

collection.holidays

object[]

Cached holiday occurrences for this category, with each entry's current override state.

Hide child attributes

collection.holidays.key

string

required

Stable holiday identifier (e.g. christmas-day). Note the field is key, not holiday_key.

collection.holidays.name

string

required

collection.holidays.date

string<date>

required

collection.holidays.excluded

boolean

required

True if this holiday is currently overridden off for the user.

collection.holidays.nextDate

string<date> | null

Next future occurrence, when distinct from date.

collection.createdAt

string<date-time> | null

collection.updatedAt

string<date-time> | null

Last modified on April 27, 2026

Preview Holidays for a Category

Create Holiday Subscriptions

List holiday subscriptions

curl --request GET \
  --url https://api.zeeg.me/v2/holidays/subscriptions \
  --header 'Authorization: Bearer <token>'

{
  "collection": [
    {
      "uuid": 42,
      "uri": "https://api.zeeg.me/v2/holidays/subscriptions/42",
      "category": {
        "type": "country",
        "key": "DE",
        "name": "Germany"
      },
      "holidays": [
        {
          "key": "new-year",
          "name": "New Year's Day",
          "date": "2026-01-01",
          "nextDate": "2027-01-01",
          "excluded": false
        },
        {
          "key": "christmas-day",
          "name": "Christmas Day",
          "date": "2026-12-25",
          "nextDate": "2027-12-25",
          "excluded": true
        }
      ],
      "createdAt": "2026-04-01T09:12:33+00:00",
      "updatedAt": "2026-04-15T08:00:00+00:00"
    }
  ]
}