Simple endpoints
Use straightforward GET requests to fetch a year, a day, a holiday check, or all available holidays.
Free • JSON • Developer friendly
New Zealand public holiday data made easy.
A clean, simple API for national and regional New Zealand public holidays. Built for developers who want fast integration and clear documentation.
Simple GET endpoints
JSON responses
Regional holiday support
Free to use
Quick start
https://api.public-holidays.nz/v1/year?apikey=YOUR_API_KEY&year=2026
Example JSON response
{
"year": 2026,
"holidays": [
{
"date": "2026-01-01",
"name": "New Year's Day",
"regional": false
},
{
"date": "2026-02-06",
"name": "Waitangi Day",
"regional": false
}
]
}
Why developers use it
Fast to understand. Easy to integrate.
No heavy setup, no complex auth flow, and no cluttered docs.
Developer-focused docs
Examples, parameter tables, code snippets, and a live request builder help you get started quickly.
Made for NZ data
Built specifically for New Zealand public holiday use cases including region-aware data handling.
Endpoints
Core API endpoints
GET
/v1/year
Return all public holidays for a year.
GET
/v1/day
Return details for a specific date.
GET
/v1/holiday
Return true or false for whether a date is a holiday.
GET
/v1/all
Return all public holidays in the database.
Free access
Request your API key
Access is free. Request an API key with a real email address as key is sent to your email.
- Easy to use and intergrate
Keep it sustainable
Free for developers. Supported by the community.
Keep the API free while using support links and carefully placed ads that do not get in the way of the documentation.