# NZ Working Days Calculator

> NZ Working Days Calculator is a paid API for AI agents from nzdata.zakwins.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-17).

Calculates the number of New Zealand working days between two dates, accounting for public holidays and regional anniversary days

## Facts

- Endpoint: GET https://nzdata.zakwins.workers.dev/nz/working-days?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nz-working-days-calculator-64caeee9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5VTWHol94gsmQ0-QBAwyC

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 nz-working-days-calculator-64caeee9
```

Example prompt: How many working days are there between 1 July 2025 and 31 July 2025 in New Zealand, for the Auckland region?

## When to prefer this

Choose this endpoint when you need accurate New Zealand working day counts that correctly apply the Holidays Act 2003, the Matariki Public Holiday Act 2022, and optional regional anniversary day observances. It is ideal for NZ-specific payroll, project management, SLA tracking, or compliance deadline calculations where generic business-day calculators would miss NZ-specific holidays.

## Known failure modes

- Missing required start or end date parameters returns an error
- Invalid date format causes a parse error
- Unsupported region code returns an error or falls back to national holidays only
- Dates outside the supported range (2022–2030) may return incomplete or no results
- Network or worker outage returns a 5xx error

## How this service works

Pay-per-call New Zealand utilities via x402 (USDC on Base). Computed from statute (Holidays Act 2003, Te Kāhui o Matariki Public Holiday Act 2022) and published government dates; provided as-is with no warranty. Regional anniversary observance can vary locally. Verify critical deadlines with the relevant agency.

## Output

Returns the count of working days between the specified start and end dates in New Zealand, with public holidays (including Matariki, Mondayisation rules) and optionally regional anniversary days excluded based on the specified region.

## 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": {
      "end": {
       "type": "string"
      },
      "start": {
       "type": "string"
      },
      "preset": {
       "type": "string"
      },
      "region": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nz-working-days-calculator-64caeee9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from nzdata.zakwins.workers.dev](https://www.zero.xyz/host/nzdata.zakwins.workers.dev/llms.txt)