Introduction | holidays.rest

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

🏠 Go to homepage
🔑 Sign Up for a Developer Key
🏥 API Status Page

Run in Postman
Use our MCP Server
Download Insomnia Collection

SDKs
Javascript
Typescript
Go
Python
Ruby
Kotlin
C# / .Net

Authentication

holidays.rest uses API keys to allow access to the API. You can register a new API key at our members area.

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

Support: [email protected]