For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • holidays.rest API
    • Introduction
    • GETcountries
    • GETcountry
    • GETlanguages
    • GETholidays
LogoLogo
On this page
  • Authentication
  • Response Format

Introduction

||View as Markdown|
Was this page helpful?
Edit this page
Next

countries

Built with

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

FormatParameterNote
json?response=jsondefault
xml?response=xml
yaml?response=yaml
csv?response=csv

Visit Holidays API

Support: [email protected]