Skip to content

NZ Public Holidays API

A standard REST based API for retrieving official NZ public holidays in XML and JSON format. Would want at least 10 years historical and 5 years forward (or the current and next year at a minimum).

Having a trusted ( consistent, reliable and stable means of getting public holiday information for use in related NZ business operations, e.g. holiday pay, scheduling, etc.

Response from Ministry of Business Innovation and Employment

Awaiting moderation


  • Steve

    This information should also be provided as an ICS file (so that it can be linked to by end-user calendaring applications) as well as in JSON format (for application integration)

  • Le-roy Staines

    Having this made available from an authoritive source is crucial for successful business applications such as time & attendance, payroll, etc.

    There are other APIs available, but for business-critical applications it would less of a liability if it was sourced directly from a government data source.

  • kevin dowd

    Adding my voice to the chorus..... - this is the kind of 'core' info that I'd expect a govt api to provide - its a good for business and should not be private

    And as someone already said it needs to be authoritative
    >>an authoritative source i.e. NZ Government.

  • Ian Hui

    Yes please

  • Fred Bai

    A free public holiday API is highly necessary for all kinds of purpose. Since most of the BI/data service just need it to be automated, doesn't need to call it 1000+ times a day.
    So, a lite API without charge will be great and highly appreciated.

  • Tony Sutherland

    The API is much needed especially since Covid businesses are moving to more electronic form of communications. So having a API to generate this information will streamline the process.

    And your comment at the top of the thread on 22 June 2021 at 15:42 03:42 pm (4 months ago). We are not asking you to duplicate information but to add and additional method to get the data rather than a PDF, and Calendar file.

  • Ieuan

    Agreed, this should be made available. Most other countries provide an official source for this, e.g.:

  • Mike Nelson

    Yes please, this is fundamental data which should be provided in a machine readable format. Even just a year in advance would be useful for most purposes. As the data already exists on MBIE website, it would be very simple to make this available. It would take one person at MBIE about an hour per year to type it into a database. There is already an existing iCal feed system at MBIE (on the dol.govt domain), which would be perfect, the problem is this is simply not being updated.

  • Ben

    Hi team,

    This would really help in pulling data automatically for systems that require it. Even for systems where vendors build this functionality in (for example, Outlook), it would be preferable to obtain from an authoritative source i.e. NZ Government.

    The current method is often manual updates each year or so - this works, but is prone to human error and creates a risk of oversight.

    Ideally the API would use the same data as (which is very helpful, but again, requires human intervention).

    Something similar to could work.

    Hope you can consider on this basis :)

    Thank you

  • Song Li

    These dates are critical to many application, e.g. Parking, consent compliance etc. Say we have 1000 businesses and local governments need this service, which costs $150/year, that is $150k per year. An option is to buy their service and make it free for any IP within NZ. Thanks.

  • Lachlan

    The link referenced in your response is a paid service. This should be public information without a subscription fee.

  • Udit Shah

    An api for public holidays is much needed with options to choose region based holidays.
    It will be great if it comes from govt to make it more reliable.
    Thank you