Openholidaysapi

OpenHolidays API v1

Open Data API for public and school holidays

Data & analytics#calendar

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Open Data API for public and school holidays

Endpoints 10

Regional

  • GETReturns a list of all supported countries/Countries
  • GETReturns a list of relevant holiday groups for a supported country (if any)/Groups?countryIsoCode=DE
  • GETReturns a list of all used languages/Languages
  • GETReturns a list of relevant subdivisions for a supported country (if any)/Subdivisions?countryIsoCode=DE

Holidays

  • GETReturns list of public holidays for a given country/PublicHolidays?countryIsoCode=DE&validFrom=2023-01-01&validTo=2023-12-31
  • GETReturns a list of public holidays from all countries for a given date./PublicHolidaysByDate?date=2023-12-25
  • GETReturns list of official school holidays for a given country/SchoolHolidays?countryIsoCode=DE&validFrom=2023-01-01&validTo=2023-12-31
  • GETReturns a list of school holidays from all countries for a given date./SchoolHolidaysByDate?date=2023-12-25

Statistics

  • GETReturns statistical data about public holidays for a given country./Statistics/PublicHolidays?countryIsoCode=DE
  • GETReturns statistical data about school holidays for a given country/Statistics/SchoolHolidays?countryIsoCode=DE

API details

Authentication
None declared in the description
Operations
10 operations on 10 pathsGET 10
Main resources
Holidays 4Regional 4Statistics 2
Response formats
application/problem+json application/json text/json text/plain
Description format
OpenAPI 3.0.4, API version v1

How to test the OpenHolidays API v1 in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the OpenHolidays API v1 collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “Returns a list of all supported countries” (GET /Countries), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the OpenHolidays API v1?

Open Data API for public and school holidays It is listed under Data & analytics and has 10 endpoints.

Who publishes the OpenHolidays API v1?

It is listed from Openholidaysapi's public API description (an OpenAPI document), not published by Openholidaysapi on Swastik Codes. Anyone who controls openholidaysapi.org can claim the profile by adding a DNS TXT record.

How do I authenticate with the OpenHolidays API v1?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the OpenHolidays API v1 have?

10 operations on 10 paths (10 GET). The largest groups are Holidays, Regional, Statistics.

Is forking the OpenHolidays API v1 free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.