***

title: Introduction
---------------------

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/llms.txt. For full documentation content, see https://docs.holidays.rest/holidays-rest-api/llms-full.txt.

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/)
* **🏥 **[**API Status Page**](https://holidays.openstatus.dev/)

***

* [**Run in Postman**](https://www.postman.com/holidays-rest/holidays-rest/collection/au7ng15/holidays-rest-api?action=share\&creator=39376222\&sideView=agentMode)
* [**Use our MCP Server**](https://www.postman.com/holidays-rest/workspace/holidays-rest/mcp-request/69e038998ef6996c17a0cc94?action=share\&creator=39376222)
* [**Download Insomnia Collection**](https://gist.github.com/msdundar/a1af00b9729a9b51c6debe066a463cff)

***

| 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)