> ## 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. # List Holiday Subscriptions > List the holiday subscriptions for users in your workspace, including which categories they follow and any per-holiday overrides. ## OpenAPI ````yaml GET /holidays/subscriptions openapi: 3.0.0 info: title: Zeeg Public API description: >- Zeeg public API documentation. ## Authentication All endpoints require a Bearer token. You can generate an API token from [your Zeeg dashboard](https://app.zeeg.me/account/settings/api-access). Each token is scoped to specific permissions (e.g. `events:read`, `webhooks:write`). Make sure your token has the required scopes for the endpoints you want to use. ## Recommended Headers We recommend including the `Accept: application/json` header in all API requests to ensure you receive JSON responses. version: 2.0.0 x-logo: url: https://app.zeeg.me/img/logo-dark.2ca83593.svg backgroundColor: '#f7f7f9' altText: zeeg contact: name: Zeeg Support email: support@zeeg.me url: https://zeeg.me/en/contact license: name: Proprietary url: https://zeeg.me/en/legal/terms termsOfService: https://zeeg.me/en/legal/terms servers: - url: https://api.zeeg.me/v2 description: Production security: - bearer: [] tags: - name: Scheduled Events description: Management of events scheduled via Zeeg - name: Scheduling Pages description: Scheduling pages information and management - name: Availability Schedule description: Read and change availability for users - name: Webhooks description: Webhooks management - name: Notes description: Notes for scheduled events - name: Workspaces & Teams description: Workspace users and team member management - name: AI Agent description: AI Agent integration endpoints - name: Payloads description: Webhook payload schemas - name: CRM - Objects description: >- Discover the schema of CRM objects (standard and custom) including all attribute definitions - name: CRM - Companies description: Create, read, update, and delete CRM company records - name: CRM - People description: Create, read, update, and delete CRM person records paths: /holidays/subscriptions: get: tags: - Availability Schedule summary: List holiday subscriptions description: >- 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`). operationId: list-holiday-subscriptions parameters: - schema: type: string format: email example: lena.meier@horizondigital.de in: query name: email required: true description: Email address of the user whose holiday subscriptions to retrieve. responses: '200': description: OK content: application/json: schema: type: object required: - collection properties: collection: type: array description: Holiday subscriptions for the user. items: type: object required: - uuid - uri - category properties: uuid: type: integer format: int64 description: Subscription identifier. uri: type: string format: uri description: >- Self-link to delete this subscription or toggle its overrides. example: https://api.zeeg.me/v2/holidays/subscriptions/42 category: type: object required: - type - key - name properties: type: type: string enum: - country - region key: type: string description: Country or region key (e.g. `DE`, `DE-BY`). name: type: string nullable: true country: type: object description: >- Parent country. Present only when `category.type` is `region`; omitted for country subscriptions to avoid duplicating `category`. required: - key - name properties: key: type: string name: type: string nullable: true holidays: type: array description: >- Cached holiday occurrences for this category, with each entry's current override state. items: type: object required: - key - name - date - excluded properties: key: type: string description: >- Stable holiday identifier (e.g. `christmas-day`). Note the field is `key`, not `holiday_key`. name: type: string date: type: string format: date nextDate: type: string format: date nullable: true description: >- Next future occurrence, when distinct from `date`. excluded: type: boolean description: >- True if this holiday is currently overridden off for the user. createdAt: type: string format: date-time nullable: true updatedAt: type: string format: date-time nullable: true examples: Country subscription: value: 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' Region subscription: value: collection: - uuid: 57 uri: https://api.zeeg.me/v2/holidays/subscriptions/57 category: type: region key: DE-BY name: Bavaria country: key: DE name: Germany holidays: - key: assumption-day name: Assumption Day date: '2026-08-15' nextDate: '2027-08-15' excluded: false createdAt: '2026-04-01T09:12:33+00:00' updatedAt: '2026-04-01T09:12:33+00:00' '401': $ref: '#/components/responses/401' '403': description: The token holder is not allowed to read this user's schedules. content: application/json: examples: Forbidden: value: success: false status: 403 message: Not allowed to see this resource. '422': description: Unprocessable Entity content: application/json: schema: type: object properties: message: type: string errors: type: object properties: email: type: array items: type: string examples: Email required: value: message: The email field is required. errors: email: - The email field is required. security: - bearer: [] components: responses: '401': description: Unauthorized content: application/json: schema: type: object properties: message: type: string example: Unauthenticated. examples: Unauthenticated: value: message: Unauthenticated. securitySchemes: bearer: type: http scheme: bearer description: '' ````