# NZ Data API
> Pay-per-call New Zealand utilities for AI agents via x402 (USDC on Base, eip155:8453). Unpaid requests return HTTP 402 with payment requirements.

MCP: https://nzdata.zakwins.workers.dev/mcp (Streamable HTTP, stateless). Same tools, paid via x402-over-MCP (_meta["x402/payment"]).

## Endpoints (GET)
- https://nzdata.zakwins.workers.dev/nz/holidays?year=2026&region=auckland ($0.002): NZ public holidays 2022-2030 incl. Matariki, Mondayisation and optional regional anniversary day
- https://nzdata.zakwins.workers.dev/nz/working-days?start=2026-10-01&end=2026-10-31&region=&preset=none ($0.002): Count NZ working days between two dates inclusive (weekends, public holidays, optional statutory Christmas shutdown presets oia|lgoima|building_act|rta)
- https://nzdata.zakwins.workers.dev/nz/working-days/add?start=2026-12-15&days=20&preset=oia ($0.002): Add N NZ working days to a date (e.g. OIA 20 working-day deadline)
- https://nzdata.zakwins.workers.dev/nz/validate/ird?number=49091850 ($0.001): Validate NZ IRD/GST number check digit
- https://nzdata.zakwins.workers.dev/nz/validate/nzbn?number=9429041535134 ($0.001): Validate NZBN (GTIN-13) check digit
- https://nzdata.zakwins.workers.dev/nz/validate/phone?number=021+123+4567 ($0.001): Validate and normalise an NZ phone number to E.164 with type
- https://nzdata.zakwins.workers.dev/nz/validate/bank?number=01-0902-0068389-00 ($0.001): Validate an NZ bank account number check digit (IRD algorithms A-G/X), normalise BB-bbbb-AAAAAAA-SSS and identify the bank code
- https://nzdata.zakwins.workers.dev/nz/gst?amount=115&mode=inclusive ($0.001): NZ GST 15% calculator (exclusive or inclusive)

Disclaimer: 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.
Sources: https://www.govt.nz/browse/work-and-tax/public-holidays-and-work/dates-for-public-holidays-and-anniversary-days/ ; https://www.employment.govt.nz/leave-and-holidays/public-holidays/public-holidays-and-anniversary-dates/ ; https://www.legislation.govt.nz/act/public/2003/0129/latest/ ; https://www.legislation.govt.nz/act/public/2022/0014/latest/ ; https://www.ird.govt.nz (IRD check-digit algorithm) ; https://www.gs1nz.org (NZBN = GTIN-13 check digit) ; https://www.ird.govt.nz/gst (GST 15%) ; https://www.ird.govt.nz (bank account number validation algorithm, payroll/RWT developer specs)