{"uid":"cap_MFqqYVhEAHeaE_g_pVs8q","slug":"nz-ird-number-validator-7858024e","name":"NZ IRD Number Validator","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/validate/ird?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":{"number":{"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.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sgLW2qZpc9L-MnZLqAzGy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a New Zealand Inland Revenue Department (IRD) number for correct format and check digit","exampleAgentPrompt":"Can you check if the IRD number 49091850 is valid for New Zealand tax purposes?","exampleUseCases":[{"title":"Payroll onboarding IRD check","prompt":"We're onboarding a new employee in NZ and they gave us their IRD number as 136410132 — can you verify it's a valid IRD number before we set up payroll?"},{"title":"Tax form pre-submission validation","prompt":"Before I submit this NZ tax return, can you validate the IRD number 49091850 to make sure it's correctly formatted and passes the check digit?"},{"title":"Client KYC identity check","prompt":"I need to verify that the IRD number a client provided, 136410132, is a properly valid New Zealand IRD number — can you check it for me?"}],"resultDescription":"Returns whether the supplied IRD number is valid, including format correctness and check digit verification. May include parsed components or error details if the number is invalid.","failureModes":["Missing 'number' query parameter returns an error","Non-numeric or incorrectly formatted input returns a validation failure","IRD numbers with invalid check digits are flagged as invalid","Network or worker-side errors may return 5xx responses","Payment failure via x402 prevents the request from completing"],"whenToPreferThis":"Use this endpoint when you need to programmatically validate New Zealand IRD numbers, particularly in payroll, HR onboarding, tax filing, or KYC workflows where confirming the check digit and format is required before downstream processing. It is a cheap, pay-per-call utility ($0.001 USDC) requiring no subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T06:38:50.542Z","isFirstParty":false,"canonicalSlug":"nz-ird-number-validator-7858024e"}