---
title: "Public holidays for a country/year (python-holidays library)"
method: GET
path: "/v1/holidays/{country_iso2}/{year}"
tags: ["data"]
---

# Public holidays for a country/year (python-holidays library)

`GET /v1/holidays/{country_iso2}/{year}`

## Request

- Base URL: `https://api.travelminds.ai`
- URL: `https://api.travelminds.ai/v1/holidays/{country_iso2}/{year}`
- Auth: none declared

List of public holidays for a country in a given year, with optional sub-national breakdown. Coverage: 200+ countries including **India with 36 state subdivisions** (subdivision='KA' for Karnataka, 'MH' for Maharashtra, etc.). Backed by the BSD-3-licensed `holidays` Python library — in-process lookup, no network hop, no rate limit. The response includes the full list of available subdivisions for the country so the caller can drill in. License: BSD-3-holidays-py.

## Path parameters

- `country_iso2` string, required
- `year` integer, required

## Query parameters

- `subdivision` string, nullable

## Headers

- `authorization` string, nullable
- `x-rapidapi-proxy-secret` string, nullable
- `x-rapidapi-user` string, nullable
- `x-tmai-proxy-secret` string, nullable
- `x-tmai-proxy-provider` string, nullable
- `x-tmai-proxy-user` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/travelminds/apis/travelmindsai-api-gateway.md) · [All operations](https://skmtc.dev/travelminds/apis/travelmindsai-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/travelminds/apis/travelmindsai-api-gateway/revisions/d05c8634e340?raw)