---
title: "List holidays"
method: GET
path: "/v1/holidays"
---

# List holidays

`GET /v1/holidays`

## Request

- Base URL: `https://bankday.dev`
- URL: `https://bankday.dev/v1/holidays`
- Auth: HTTP bearer

Holidays for a year (default: current year) or a date range up to 10 years. For joint calendars every calendar's holidays are listed with a calendar field. Exchange calendars with shortened sessions also return early_closes for the range.

## Query parameters

- `calendar` string, required
- `year` string
- `start` string, date
- `end` string, date

## Response `200`

OK

- object

## Other responses

- `400`: Error
- `401`: Error
- `404`: Error
- `422`: Error
- `429`: Error

---

[API](https://skmtc.dev/bankday/apis/bankday-api.md) · [All operations](https://skmtc.dev/bankday/apis/bankday-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bankday/apis/bankday-api/revisions/64cfaa415994?raw)