# NZ IRD Number Validator

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

Validates a New Zealand Inland Revenue Department (IRD) number for correct format and check digit

## Facts

- Endpoint: GET https://nzdata.zakwins.workers.dev/nz/validate/ird?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nz-ird-number-validator-7858024e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MFqqYVhEAHeaE_g_pVs8q

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-ird-number-validator-7858024e
```

Example prompt: Can you check if the IRD number 49091850 is valid for New Zealand tax purposes?

## When to prefer this

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.

## Known failure modes

- 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

## 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 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.

## 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": {
      "number": {
       "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-ird-number-validator-7858024e/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)