> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.holidays.rest/holidays-rest-api/introduction/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.holidays.rest/_mcp/server.

# Introduction

holidays.rest is a highly available, high-performance, enterprise-grade public and bank holiday API.

---

* **🏠 **[***Go to homepage***](https://www.holidays.rest/)
* **🔑 **[**Sign Up for a Developer Key**](https://www.holidays.rest/dashboard)
* **🏥 **[**API Status Page**](https://holidays.openstatus.dev/)

---

* [**Run in Postman**](https://www.postman.com/dinazor-io/holidays-rest/collection/au7ng15/holidays-rest-api?action=share\&creator=39376222)
* [**Use our MCP Server**](https://www.postman.com/dinazor-io/holidays-rest/collection/69e038988ef6996c17a0cc93/holidays-rest-mcp-server?action=share\&creator=39376222)

---

| SDKs                                                     |
| -------------------------------------------------------- |
| [Javascript](https://github.com/holidays-rest/sdk-js)    |
| [Typescript](https://github.com/holidays-rest/sdk-ts)    |
| [Go](https://github.com/holidays-rest/sdk-go)            |
| [Python](https://github.com/holidays-rest/sdk-py)        |
| [Ruby](https://github.com/holidays-rest/sdk-ruby)        |
| [Kotlin](https://github.com/holidays-rest/sdk-kotlin)    |
| [C# / .Net](https://github.com/holidays-rest/sdk-csharp) |

---

## Authentication

holidays.rest uses API keys to allow access to the API. You can register a new API key at our [members area](https://www.holidays.rest/dashboard).

holidays.rest expects for the API key to be included in all API requests to the server in a header that looks like the following:

`Authorization: Bearer YOUR_API_KEY`

## Response Format

All responses are formatted in JSON by default. However, you can request responses in XML, YAML and CSV formats by adding the `response` query parameter as follows:

| Format | Parameter        | Note    |
| ------ | ---------------- | ------- |
| json   | `?response=json` | default |
| xml    | `?response=xml`  |         |
| yaml   | `?response=yaml` |         |
| csv    | `?response=csv`  |         |

---

Visit [Holidays API](https://www.holidays.rest)

Support: [hello@holidays.rest](https://mailto:hello@holidays.rest)