---
title: "List holidays"
method: GET
path: "/v1/holiday-calendar/{holiday_calendar_id}/holiday"
tags: ["Holiday calendar data"]
---

# List holidays

`GET /v1/holiday-calendar/{holiday_calendar_id}/holiday`

## Request

- Base URL: `https://sandbox.pismolabs.io/holidays-core`
- URL: `https://sandbox.pismolabs.io/holidays-core/v1/holiday-calendar/{holiday_calendar_id}/holiday`
- Auth: HTTP bearer

List calendar holidays

## Path parameters

- `holiday_calendar_id` string, required

## Query parameters

- `name` string
- `beginDate` string
- `endDate` string
- `page` integer
- `perPage` integer
- `order` 'ASC' | 'DESC'
- `orderBy` 'ID' | 'NAME'
- `include_parent_holidays` boolean

## Response `200`

OK

- PresenterListHolidayResponse
  - `current_page` integer: Current result page
  - `pages` integer: Total number of result pages.
  - `per_page` integer: Maximum results per page
  - `total_items` integer: Total number of result items
  - `items` PresenterGetHolidayResponse[]
    - `created_at` string, datetime: Date and time the holiday was created. Format = yyyy-mm-ddTHH:mm:ss.
    - `deleted_at` string, datetime: Date and time the holiday was deleted. Format = yyyy-mm-ddTHH:mm:ss.
    - `description` string: Holiday description
    - `holiday_calendar` HolidayCalendar
      - `id` integer: Holiday calendar ID
      - `name` string: Holiday calendar name. Must be unique per organization.
    - `holiday_date` string: Holiday date. Format = yyyy-mm-dd.
    - `holiday_id` integer: Holiday ID
    - `metadata` Metadata: A valid JSON schema as specified in https://json-schema.org/specification.html. Used to register rules used to authorize the transaction. **Note**: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to [Get started with Pismo APIs](ref:get-started-with-pismo-apis#metadata).
    - `name` string: Holiday name
    - `updated_at` string, datetime: Date and time the holiday was updated. Format = yyyy-mm-ddTHH:mm:ss.

## Other responses

- `400`: Bad request
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/platform-setup-holidays.md) - [All operations](https://skmtc.dev/pismo/apis/platform-setup-holidays/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/platform-setup-holidays/revisions/53e8339180bd?raw)