# Calculate New Zealand provisional tax

Calculate supported standard, estimation or ratio provisional-tax instalments for eligible New Zealand cases, using the stated tax year and method.

Canonical: https://aroai.com/tools/nz_provisional_tax/

## Tool reference

MCP tool ID: `nz_provisional_tax`. Availability: Live. Country: New Zealand.

Credit use: 1 credit.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "tax_year": {
      "type": "string",
      "enum": [
        "2025-26",
        "2026-27"
      ]
    },
    "method": {
      "type": "string",
      "enum": [
        "standard",
        "estimation",
        "ratio"
      ]
    },
    "prior_year_rit": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000
    },
    "two_years_prior_rit": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000
    },
    "has_extension_of_time": {
      "type": "boolean"
    },
    "filing_timing": {
      "type": "string",
      "enum": [
        "before_first",
        "after_first",
        "after_second"
      ]
    },
    "estimated_rit": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000
    },
    "ird_issued_rate": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Enter a decimal fraction, for example 0.085 for 8.5%."
    },
    "instalment_income_ex_gst": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000
    },
    "period_number": {
      "type": "integer",
      "minimum": 1,
      "maximum": 6
    }
  },
  "required": [
    "tax_year",
    "method"
  ],
  "additionalProperties": false
}
```