{"uid":"cap_YqXa5fbE4ie1ig7pVTtHr","slug":"nz-public-holidays-api-2442b54d","name":"NZ Public Holidays API","description":"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.","url":"https://nzdata.zakwins.workers.dev/nz/holidays?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":{"year":{"type":"string"},"region":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0Ckdoc5c4CZH7iOMWnM4a","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns New Zealand public holidays for a given year and optional region, including Matariki, Mondayisation, and regional anniversary days, for years 2022–2030.","exampleAgentPrompt":"What are all the public holidays in New Zealand for 2025, including the Auckland regional anniversary day and Matariki?","exampleUseCases":[{"title":"Payroll compliance calendar planning","prompt":"I need a list of all New Zealand public holidays for 2024 so I can make sure we're paying staff correctly on statutory days — include any Mondayised holidays."},{"title":"Scheduling around Wellington anniversary","prompt":"Can you tell me when the Wellington anniversary day is in 2025? I want to make sure we don't schedule any deliveries or customer calls on that day."},{"title":"Developer holiday-aware app feature","prompt":"Give me all NZ public holidays for 2026 including Matariki — I'm building a booking calendar and need to block those dates out for New Zealand users."}],"resultDescription":"A list of New Zealand public holidays for the requested year (2022–2030), each with the holiday name and date. Optionally includes regional anniversary days when a region is specified. Matariki dates and Mondayisation shifts are included as computed from the Holidays Act 2003.","failureModes":["Year outside the supported range (2022–2030) returns an error or empty response","Invalid or unrecognised region code returns no regional holiday or an error","Missing required method or type fields in the request body cause a validation error","Network or Cloudflare Worker downtime may result in 5xx errors"],"whenToPreferThis":"Choose this endpoint when you need accurate, statute-derived New Zealand public holiday data including Matariki (which changes each year), Mondayisation rules, and optional regional anniversary days for a specific year between 2022 and 2030. It is preferable over generic calendar APIs that may not correctly implement NZ-specific holiday logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T06:35:53.682Z","isFirstParty":false,"canonicalSlug":"nz-public-holidays-api-2442b54d"}