-
Welcome to the only NZ Public Holidays API
An API that has all New Zealand Public Holidays returned in JSON format
Designed to provide real-time, accurate information on public holidays for New Zealand.
Whether you're planning a business schedule, organizing events, or just curious about upcoming public holidays, our API delivers the essential details you need.
With access to holiday data for all New Zealand regions, it allows developers to seamlessly integrate public holiday information into their apps, websites, or systems.
The service is updated regularly to reflect any changes in national and regional holidays, ensuring that you stay informed and up to date.
Our user-friendly API offers a straightforward interface for easy integration, making it a valuable tool for businesses and individuals alike.
From tracking national holidays to finding region-specific observances, our service simplifies the process of holiday management.
Flexible querying options, and reliable performance, the Public Holiday API is the go-to solution for anyone needing precise holiday data at their fingertips.
Start using the API today and enhance your applications with the most up-to-date public holiday information available.
-
Help to keep this service running
This is a free service for all to use, if you use and get bennefit from this service please consider supporting me buy buying me a coffee or becoming a member
-
How to use the API
The API uses in-line requests via GET
Year
Return all public holidays in a year for example 2023
https://api.public-holidays.nz/v1/year?apikey=yourapikey&year=2023Day
Return the details of a specific day for example 25/12/2022 (dd/mm/yyyy or dd-mm-yyyy)
https://api.public-holidays.nz/v1/day?apikey=yourapikey&date=25/12/2022Holiday
Return a True/False for a specific day for example 25/12/2022 (dd/mm/yyyy or dd-mm-yyyy)
https://api.public-holidays.nz/v1/holiday?apikey=yourapikey&date=25/12/2022Year
Return all public holidays in a year for example 2023
https://api.public-holidays.nz/v1/year?apikey=yourapikey&year=2023All
Return all public holidays in the database
https://api.public-holidays.nz/v1/all?apikey=yourapikeyAPI Keys
You will need to register to get an API key it is free but you will need to provide a real email address for the api key to be emailed to you
Your email address will only ever be used to contact you for API related information -
Request APIKey
You will need to register to get an API key it is free but you will need to provide a real email address for the api key to be emailed to you
Your email address will only ever be used to contact you for API related informationPlease consider supporting the website hereEmail: info @ public-holidays.nz