---
title: "Read a member's holiday settings"
description: "Returns the member's holiday country and disabled holiday ids plus the cached current- and next-year holidays with enabled status (future dates only unless include_past=true)."
api_method: GET
api_path: "/v1/holidays/settings"
canonical_url: https://wiblo.app/docs/developers/api/holidays/get-holiday-settings
last_updated: 2026-07-28T18:08:25+02:00
md_url: https://wiblo.app/docs/developers/api/holidays/get-holiday-settings.md
---

# Read a member's holiday settings

`GET /v1/holidays/settings`

Returns the member's holiday country and disabled holiday ids plus the cached current- and next-year holidays with enabled status (future dates only unless `include_past=true`). `member_id` defaults to the caller's own member row; any active member may read any member's settings (the schedules/OOO visibility rule). A member without a settings row gets the synthesized default (null country, holidays off). The read lazily refreshes expired cache tranches from Google and serves stale rows when the refetch fails. Per-user rate-limited at 60/60s.

## Query parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `member_id` | `string` | No | Member whose settings to read; defaults to the caller's own member row. |
| `include_past` | `"true" \| "false"` | No | `true` also lists holidays whose date has passed; the default lists future dates only. |

## Headers

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `X-Wiblo-Workspace` | `string` | Yes | Workspace id the call is scoped to. The actor must hold an active membership in it; a foreign or unknown id collapses onto 404 WORKSPACE_NOT_FOUND. |

## Request

**curl**

```bash
curl "https://api.wiblo.app/v1/holidays/settings?member_id=5f2d8c1b-7e4a-4b9d-a6c3-1d8e5f2a7b4c" \
  -H "Authorization: Bearer $WIBLO_TOKEN" \
  -H "X-Wiblo-Workspace: $WIBLO_WORKSPACE_ID"
```

**TypeScript**

```ts
import { createSdk, getHolidaySettings } from "@workspace/sdk"

const sdk = createSdk({ baseUrl: "https://api.wiblo.app" })

const { data, error } = await getHolidaySettings({
  client: sdk,
  query: { member_id: "5f2d8c1b-7e4a-4b9d-a6c3-1d8e5f2a7b4c" },
  headers: { "X-Wiblo-Workspace": "..." },
})
```

## Example response

```json
{
  "settings": {
    "member_id": "5f2d8c1b-7e4a-4b9d-a6c3-1d8e5f2a7b4c",
    "country_code": "GB",
    "disabled_event_ids": [
      "20260831_60o30dr56ko30c1g60o30dr56g"
    ]
  },
  "holidays": [
    {
      "event_id": "20260831_60o30dr56ko30c1g60o30dr56g",
      "name": "Summer Bank Holiday",
      "date": "2026-08-31",
      "year": 2026,
      "enabled": false
    },
    {
      "event_id": "20261225_8kr34cpj6cq34bb469i38e9k74",
      "name": "Christmas Day",
      "date": "2026-12-25",
      "year": 2026,
      "enabled": true
    },
    {
      "event_id": "20270101_c4o34e1g60o30c1g60o30dr56g",
      "name": "New Year's Day",
      "date": "2027-01-01",
      "year": 2027,
      "enabled": true
    },
    {
      "event_id": "20270326_8h0k8gr36gpj4bb26op38d9l6o",
      "name": "Good Friday",
      "date": "2027-03-26",
      "year": 2027,
      "enabled": true
    }
  ]
}
```

## Responses

**`200`** — The member's settings plus holiday statuses. Returns `HolidaySettingsResponse`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `settings` | `object` | Yes | The member's stored settings, or the synthesized default (`null` country, empty disabled set) when no row exists. |
| `settings.member_id` | `string` | Yes | Workspace member these settings belong to. |
| `settings.country_code` | `string \| null` | Yes | The member's holiday country (ISO 3166-1 alpha-2, uppercase); `null` means holiday blocking is off. |
| `settings.disabled_event_ids` | `array<string>` | Yes | Holiday event ids the member has opted out of; disabled holidays never block availability. |
| `holidays` | `array<HolidayWithStatus>` | Yes | Cached holidays for the current and next year with their enabled status — future dates only unless the GET's `include_past=true`; empty when no country is set. |

**`400`** — A query parameter failed validation, or the `X-Wiblo-Workspace` header was missing (`VALIDATION_FAILED`). Returns `ApiErrorEnvelope`.

**`401`** — No valid session cookie or `wbl_*` bearer was present. Returns `ApiErrorEnvelope`.

**`404`** — The workspace collapsed (`WORKSPACE_NOT_FOUND`) or `member_id` is unknown/cross-workspace (`MEMBER_NOT_FOUND`). Returns `ApiErrorEnvelope`.

**`422`** — The member is a machine member (`MEMBER_MUST_BE_HUMAN`, ADR 0002). Returns `ApiErrorEnvelope`.

**`429`** — Rate limit exceeded. The body's `error.code` is `RATE_LIMITED` and `error.details.retry_after` is the same number of seconds as the `Retry-After` header. Returns `ApiErrorEnvelope`.

### The HolidayWithStatus object

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `event_id` | `string` | Yes | Stable id of the holiday event in the source Google calendar; the key used in `disabled_event_ids`. |
| `name` | `string` | Yes | Display name of the holiday. |
| `date` | `string` | Yes | Date of the holiday (`YYYY-MM-DD`). |
| `year` | `integer` | Yes | Calendar year of `date`. |
| `enabled` | `boolean` | Yes | Whether the holiday blocks this member's availability; `false` when its `event_id` is in `disabled_event_ids`. |