---
title: "List all holidays of a country"
method: GET
path: "/v1/countries/{country_code}/holidays/{year}"
tags: ["Countries"]
---

# List all holidays of a country

`GET /v1/countries/{country_code}/holidays/{year}`

List all holidays of a country for a specific year. Optionally, it can be filtered by country subdivision.

## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage company resources (`company_admin`) | View countries (`country:read`) | - |

## Path parameters

- `country_code` string, required
- `year` string, required

## Query parameters

- `country_subdivision_code` string

## Headers

- `Authorization` string, required

## Response `200`

Success

- HolidaysResponse — Holidays response
  - `data` Holiday[]
    - `day` string, date, required — Date of the holiday
    - `name` string, required — Name of the holiday
    - `note` string, nullable — Notes about the holiday
    - `observed_day` string, date, nullable — Date when the holiday is observed

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/revisions/7e6a0c61ac82/schema)