# public-holidays-new-zealand

> public-holidays-new-zealand is a paid API for AI agents from intel.rallylive.ca, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-19).

Returns all national and regional public holidays in New Zealand for a specified year, including dates, names, regional scope, and weekday information.

## Facts

- Endpoint: GET https://intel.rallylive.ca/data/holidays/nz?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/public-holidays-new-zealand-10137781
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V-G1XzXo36xBZTm8yNIQ1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability public-holidays-new-zealand-10137781
```

Example prompt: What are all the public holidays in New Zealand for 2025, including which ones are regional and which regions observe them?

## When to prefer this

Choose this endpoint when you need structured, machine-readable New Zealand public holiday data for scheduling, business-day checks, or calendar planning without requiring an API key. It is especially useful for applications that need to distinguish national from regional holidays and know exactly which NZ regions observe each one.

## Known failure modes

- Missing or invalid year parameter returns an error or empty list
- Years far in the future or past may not be supported by the underlying Nager.Date dataset
- Network or provider downtime results in a failed request
- Non-integer or malformed year values may cause a parsing error

## How this service works

Public holidays in New Zealand for a given year: every national and regional public holiday with date, local and English names, whether it is nationwide or which regions observe it, and the weekday, from the Nager.Date public holiday dataset. Business-day and scheduling checks for New Zealand without an API key. $0.01 per year.

## Output

A list of New Zealand public holidays for the requested year, each with the date, local name, English name, weekday, and whether the holiday is nationwide or limited to specific regions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/public-holidays-new-zealand-10137781/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from intel.rallylive.ca](https://www.zero.xyz/host/intel.rallylive.ca/llms.txt)