---
title: "Return public holidays for a country and year. Names are returned in English wherever the country publishes it; pass ?lang= for another (Kenya also publishes sw)."
method: GET
path: "/api/v1/location/countries/{country_code}/holidays/{year}"
tags: ["Location"]
---

# Return public holidays for a country and year. Names are returned in English wherever the country publishes it; pass ?lang= for another (Kenya also publishes sw).

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

## Request

- Base URL: `https://mansaapi.com`
- URL: `https://mansaapi.com/api/v1/location/countries/{country_code}/holidays/{year}`
- Auth: HTTP bearer

## Path parameters

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

## Query parameters

- `lang` string

## Response `200`

Successful response

- object
  - `success` boolean
  - `data` object
  - `meta` object
  - `pagination` object

## Other responses

- `401`: Missing or invalid API key. error.code is MISSING_API_KEY when no key was sent, INVALID_API_KEY when the key is not recognised.
- `429`: Daily rate limit exceeded

---

[API](https://skmtc.dev/mansaapi/apis/mansa-api.md) · [All operations](https://skmtc.dev/mansaapi/apis/mansa-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mansaapi/apis/mansa-api/revisions/437615faf619?raw)