OpenHolidays

Use the OpenHolidays API to list public holidays for a specified country and year

get

Query parameters

countrystringRequired

The ISO 3166-1 country to fetch public holidays for

Example: NL

yearanyRequired

The year, up to ~5 years in the future

Example: 2022

Header parameters

Acceptstring · enumOptional

The content-type to respond with

Example: application/jsonPossible values:

Accept-LanguagestringOptional

The language to return the results in

Responses

200

Success

application/jsontext/calendar

anyOptional

400

Validation error

application/json

402

Payment required

application/json

get

/open-holidays/v1/public

HTTPcURLJavaScriptPython

GET /open-holidays/v1/public?country=text&year=null HTTP/1.1
Host: api.auor.io
Accept: */*

No content

Use the OpenHolidays API to list school holidays for a specified country and year

get

Query parameters

countrystringRequired

The ISO 3166-1 country to fetch school holidays for

Example: ZA

subdivisionstringOptional

The specific subdivision to filter by

yearanyRequired

The year, up to ~5 years in the future

Example: 2025

Header parameters

Acceptstring · enumOptional

The content-type to respond with

Example: application/jsonPossible values:

Accept-LanguagestringOptional

The language to return the results in

Responses

200

Success

application/jsontext/calendar

anyOptional

400

Validation error

application/json

402

Payment required

application/json

get

/open-holidays/v1/school

HTTPcURLJavaScriptPython

GET /open-holidays/v1/school?country=text&year=null HTTP/1.1
Host: api.auor.io
Accept: */*

No content

Use the OpenHolidays API to list sub divisions for a specified country

get

Query parameters

countrystringRequired

The ISO 3166-1 country to fetch school holidays for

Example: ZH

Header parameters

Accept-LanguagestringOptional

The language to return the results in

Responses

200

Success

application/json

anyOptional

400

Validation error

application/json

402

Payment required

application/json

get

/open-holidays/v1/subdivisions

HTTPcURLJavaScriptPython

GET /open-holidays/v1/subdivisions?country=text HTTP/1.1
Host: api.auor.io
Accept: */*

No content