---
title: "List holidays by country"
method: GET
path: "/holidays"
tags: ["Holidays"]
---

# List holidays by country

`GET /holidays`

Returns a list of bank holidays for the specified country and/or year. Each holiday includes the timezone of the country.

## Response `200`

A list of holidays

- object
  - `holidays` object[]
    - `date` string, date — The date of the holiday in ISO 8601 format.
    - `country_code` string — The two-letter country code.
    - `name` string — The name of the holiday.
    - `timezone` string — The IANA timezone for the country where the holiday applies.

## Other responses

- `400` — Invalid params
- `403` — Forbidden (e.g: wrong API Key)

---

[API](https://skmtc.net/shinkansen/apis/payouts-shinkansen-endpoints.md) · [All operations](https://skmtc.net/shinkansen/apis/payouts-shinkansen-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shinkansen/payouts-shinkansen-endpoints/versions/1e4a6760b7e8/schema)