---
title: "List holidays (deprecated)"
method: GET
path: "/holidays-core/v2/holiday"
tags: ["Holidays v2 - Transaction banking (deprecated)"]
deprecated: true
---

# List holidays (deprecated)

`GET /holidays-core/v2/holiday`

> **Deprecated.**

**DEPRECATED**. Call the new [List holidays](https://developers.pismo.io/pismo-docs/reference/get-holiday-new) endpoint instead.

This endpoint is deprecated starting April 30, 2026, and final removal from both test (EXT) and production environments on October 30, 2026.

Return a paginated list of holidays registered for an organization. 

**Note:** This endpoint is designed for transaction banking. For more information, refer to [Calendars and holidays in transaction banking](https://developers.pismo.io/pismo-docs/docs/calendars-and-holidays-in-transaction-banking).

## Query parameters

- `page` integer
- `perPage` integer
- `order` 'ASC' | 'DESC'
- `orderBy` 'ID' | 'NAME'
- `administrativeDivisionId` integer, required
- `name` string
- `holidayDate` string
- `begin_date` string, required
- `end_date` string, required
- `deleted` boolean

## Response `200`

OK

- PaginationV2Pagination
  - `current_page` integer — Current page number
  - `items` PresenterHolidayV2Response[]
    - `administrative_division` PresenterAdministrativeDivisionResponse
      - `id` integer — Administrative division ID
      - `name` string — Administrative division name
    - `id` integer — Holiday ID
    - `name` string — Holiday name
    - `description` string — Holiday description
    - `holiday_date` string — Holiday date. Format = yyyy-mm-dd.
    - `working_date` string, date — Next work day following the holiday. Format = yyyy-mm-dd.
    - `metadata` string — Any data object with key/value pairs. No limit on length. **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](https://developers.pismo.io/pismo-docs/reference/get-started-with-pismo-apis#metadata).
    - `created_at` string, date-time — Datetime program calendar strategy was created. Format = YYYY-MM-DDTHH:MM:SS:MM.
  - `pages` integer — Number of pages
  - `per_page` integer — Maximum number of items per page
  - `total_items` integer — Total number of items

## Other responses

- `400` — Bad request
- `401` — Access token is missing or invalid
- `404` — Not Found
- `500` — Internal server error

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)