New Zealand GST Number Validation API
Validate New Zealand GST Number numbers via REST API. Backed by Format + check digit (NZBN register lookup coming) — returns registration status, company name, and address in a single call.
Quick start
CURL
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://www.taxid.dev/api/v1/validate/NZ/9429000106078
Single validation
Validate one New Zealand GST Number number. Returns full company details for valid numbers.
const res = await fetch(
'https://www.taxid.dev/api/v1/validate/NZ/9429000106078',
{ headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
const data = await res.json();
/*
{
"valid": true,
"status": "active",
"company_name": "Example GmbH",
"address": "Musterstraße 1, New Zealand",
"country_code": "NZ",
"vat_number": "9429000106078",
"cached": false,
"request_id": "req_01abc..."
}
*/Response format
{
"valid": true,
"status": "active",
"company_name": "Example New Zealand Ltd",
"address": "Musterstraße 1, New Zealand",
"country_code": "NZ",
"vat_number": "9429000106078",
"cached": false,
"request_id": "req_01abc..."
}| Field | Type | Description |
|---|---|---|
| valid | boolean | true if the number is registered and active |
| status | string | "active", "inactive", "not_found", or "invalid_format" |
| company_name | string | null | Registered company name (where available from authority) |
| address | string | null | Registered address (where available from authority) |
| country_code | string | ISO 2-letter code — always "NZ" for this endpoint |
| vat_number | string | The VAT number as sent in the request |
| cached | boolean | true if result served from cache (valid: 24h, invalid: 1h) |
| request_id | string | Unique request ID for support and audit logs |
Batch validation
Validate up to 25 numbers in a single POST request. Numbers are processed in parallel — ideal for onboarding flows and nightly reconciliation.
curl -s -X POST https://www.taxid.dev/api/v1/validate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"numbers": [
{ "country": "NZ", "vat": "9429000106078" },
{ "country": "NZ", "vat": "9429000106079" }
]
}'[
{
"vat": "9429000106078",
"valid": true,
"status": "active",
"company_name": "Example Ltd",
"country_code": "NZ",
"cached": false
},
{
"vat": "9429000106079",
"valid": false,
"status": "not_found",
"country_code": "NZ",
"cached": false
}
]Error codes
| HTTP status | Meaning | Action |
|---|---|---|
| 400 | Bad request — malformed VAT format | Check the VAT format against the pattern below |
| 401 | Missing or invalid API key | Pass a valid Bearer token in the Authorization header |
| 404 | Country not supported | Check /vat-api for the full list of supported countries |
| 422 | Validation failed — invalid format | The number does not match the expected format |
| 429 | Rate limit exceeded | Back off and retry after the Retry-After header value |
| 503 | Upstream authority unavailable | VIES/authority is temporarily down — retry with exponential backoff |
New Zealand GST Number format reference
| Property | Value |
|---|---|
| Country code (ISO) | NZ |
| Local name | GST Number (Goods and Services Tax Registration Number) |
| Format | NZBN: 13 digits starting 94; or GST (IRD) number: 8 or 9 digits |
| Regex | ^(94[0-9]{11}|[0-9]{8,9})$ |
| Example | 9429000106078 |
| Standard rate | 15% |
| Validation source | Format + check digit (NZBN register lookup coming) |
| VIES supported | No |
New Zealand's GST is a flat 15% with no reduced rates, making it one of the simpler VAT/GST regimes globally. GST numbers are 8 or 9 digits and are the business's IRD (Inland Revenue Department) number; there is no public GST register. Businesses also hold a 13-digit NZBN (New Zealand Business Number), which TaxID looks up in the NZBN register. Businesses with annual turnover over NZD 60,000 must register.
Frequently asked questions
What does the TaxID API return for a New Zealand GST Number validation?
For a valid New Zealand GST Number number the API returns: `valid: true`, `status: "active"`, plus `company_name` and `address` where available from Format + check digit (NZBN register lookup coming). For invalid numbers it returns `valid: false` with a reason code. All fields are documented in the API reference.
How fast is the New Zealand GST Number validation API?
Cached results (valid numbers are cached 24h, invalid 1h) respond in under 10ms. Uncached requests that require a live lookup via Format + check digit (NZBN register lookup coming) typically complete in 100–400ms. The `cached` field in the response tells you whether the result came from cache.
What is the New Zealand GST Number number format?
New Zealand GST Number numbers (GST Number (Goods and Services Tax Registration Number)) follow the pattern: NZBN: 13 digits starting 94; or GST (IRD) number: 8 or 9 digits. A valid example is `9429000106078`. The TaxID API validates the format locally before making any live request, so malformed numbers fail instantly without consuming your quota.
Can I validate multiple New Zealand GST Number numbers in one request?
Yes. The batch endpoint (POST /api/v1/validate) accepts up to 25 VAT numbers in a single request, processed in parallel. This is ideal for bulk onboarding flows, nightly reconciliation jobs, or importing customer lists. Each item in the response array maps 1-to-1 with your input array.
Start validating New Zealand GST Number numbers
Free plan — 100 validations/month. No credit card required.
Integrate with your stack:
More New Zealand resources:
Validate VAT in other countries: