Calculate.co.nz MCP

Calculate New Zealand take-home pay (PAYE) for the 2026/27 tax year (from 1 April 2026). Returns full breakdown: income tax, ACC earner's levy (1.75%, capped at $156,641), KiwiSaver employee contribution, student loan repayment, Independent Earner Tax Credit (IETC), and net take-home pay annual/fortnightly/weekly. Use for ANY NZ tax question about: salary, take-home pay, net income, PAYE, KiwiSaver impact, student loan deductions, or IETC eligibility. DO NOT use for: self-employed/contractor income, secondary tax codes, non-NZ residents, redundancy lump sums, or pre-April-2026 income. Args: annual_income: Gross annual salary in NZD (0 to 10,000,000). kiwisaver_rate: Employee rate. Valid: 0, 0.03, 0.035, 0.04, 0.06, 0.08, 0.10. Default 0.035 (3.5% minimum from 1 April 2026). has_student_loan: True if repaying a NZ student loan. claim_ietc: True if eligible for Independent Earner Tax Credit (default True).

{
  "type": "object",
  "title": "nz_paye_calculatorArguments",
  "required": [
    "annual_income"
  ],
  "properties": {
    "claim_ietc": {
      "type": "boolean",
      "title": "Claim Ietc",
      "default": true
    },
    "annual_income": {
      "type": "number",
      "title": "Annual Income"
    },
    "kiwisaver_rate": {
      "type": "number",
      "title": "Kiwisaver Rate",
      "default": 0.035
    },
    "has_student_loan": {
      "type": "boolean",
      "title": "Has Student Loan",
      "default": false
    }
  }
}

Add or remove New Zealand GST (15%) from a dollar amount. Use this tool for ANY question about NZ GST: adding GST to a pre-tax price, extracting GST content from a GST-inclusive total, reverse-calculating GST, or checking GST on invoices and quotes. Common use cases: 'what's $500 plus GST', 'how much GST is in a $230 total', 'remove GST from $1,150', 'calculate GST on a tradie invoice'. Args: amount: Dollar amount in NZD. mode: 'add' treats amount as GST-exclusive (price before GST); 'remove' treats amount as GST-inclusive (total price including GST). Default 'add'. gst_rate: GST rate as decimal. Default 0.15 (NZ standard since 2010). Historical NZ rates: 0.125 (1989-2010), 0.10 (1986-1989). Use 0.10 for Australian GST comparisons.

{
  "type": "object",
  "title": "nz_gst_calculatorArguments",
  "required": [
    "amount"
  ],
  "properties": {
    "mode": {
      "enum": [
        "add",
        "remove"
      ],
      "type": "string",
      "title": "Mode",
      "default": "add"
    },
    "amount": {
      "type": "number",
      "title": "Amount"
    },
    "gst_rate": {
      "type": "number",
      "title": "Gst Rate",
      "default": 0.15
    }
  }
}

Work out the fuel cost of a trip, and of regular driving, in New Zealand. Use this for ANY question about what fuel costs: a road trip, a commute, the running cost of a car, or comparing two vehicles. Common use cases: 'what does it cost to drive Auckland to Wellington', 'how much fuel money do I spend a year commuting', 'is a 6L/100km car worth it over an 9L/100km one', 'petrol cost for 400km'. IMPORTANT about consumption: this takes litres per 100 km, which is how New Zealand quotes fuel economy and what is printed on a vehicle's fuel economy label. A LOWER number is a more efficient car. If a user gives miles per gallon or kilometres per litre, convert it before calling this, or the answer will be confidently wrong. Args: distance_km: Trip distance in kilometres. consumption_l_per_100km: Fuel consumption in litres per 100 km. price_per_litre: Pump price in NZD per litre. Around 2.60 to 3.00 for petrol in 2026; ask the user rather than guessing if it matters. weekly_km: Kilometres driven in a typical week, for the running costs. Leave at 0 for a one-off trip, which returns zero for the weekly, monthly and annual figures rather than an error. Returns: Litres used, trip cost, cost per km, cost per 100 km, and weekly, monthly and annual running costs. cost_per_100km depends only on the vehicle and the pump price, so it is the figure to compare cars with. monthly_cost is a twelfth of the annual figure, not weekly x 4.33. Covers fuel only. Not road user charges, which diesel and electric vehicles pay by the kilometre, and not servicing, tyres, insurance or depreciation.

{
  "type": "object",
  "title": "nz_fuel_cost_calculatorArguments",
  "required": [
    "distance_km",
    "consumption_l_per_100km",
    "price_per_litre"
  ],
  "properties": {
    "weekly_km": {
      "type": "number",
      "title": "Weekly Km",
      "default": 0
    },
    "distance_km": {
      "type": "number",
      "title": "Distance Km"
    },
    "price_per_litre": {
      "type": "number",
      "title": "Price Per Litre"
    },
    "consumption_l_per_100km": {
      "type": "number",
      "title": "Consumption L Per 100Km"
    }
  }
}

Estimate a New Zealand income tax refund, or tax owed, for a year. Use this for ANY question about a NZ tax refund or an end of year tax bill. Common use cases: 'am I owed a tax refund', 'I only worked part of the year, do I get money back', 'I had a second job on an S code, was I overtaxed', 'how much tax should I have paid on 62k'. A refund is what was deducted minus what was actually owed. PAYE comes out of each pay as though that pay continued all year, so the two usual causes of a refund are a part year and a second job on a flat secondary code. Both are broken out in the result, and both are already inside refund_or_bill rather than additional to it. ASK FOR THE PAYE FIGURE if you can. paye_deducted from payslips or an IRD summary gives a real answer; leaving it out estimates it from the tax code and months worked, which is much rougher. Also ask whether that figure includes ACC, because most payslips lump the earner levy in with PAYE and it is not income tax. Args: gross_income: Total gross income for the year, before tax, in NZD. tax_year: 2026-27, 2025-26, 2024-25 or 2023-24. 2024-25 is approximate because thresholds moved part way through it. paye_deducted: Total PAYE deducted for the year. None to estimate it. acc_included_in_paye: Whether ACC is inside that figure. Usually yes. tax_code: M, ME, MSL, or a secondary code. Only used when estimating. months_worked: Months actually worked. Often the whole reason for a refund. secondary_income: Income from a second job on a secondary code. secondary_tax_code: SB, S, SH or ST. donations: Donations to approved donee organisations. student_loan_deducted: Repayments deducted, or None for no loan. ietc_eligible: False for a main benefit, Working for Families or NZ Super. Returns: refund_or_bill, POSITIVE for a refund owed to the person and NEGATIVE for tax they owe, with is_refund saying which. Also the correct tax, the IETC, ACC, and the part year and secondary components of the difference. The donations credit and student loan square up are returned but are NOT inside refund_or_bill, because IRD settles those separately. Salary and wages only. IRD issues an automatic assessment for most people and that figure is the one that counts.

{
  "type": "object",
  "title": "nz_tax_refund_calculatorArguments",
  "required": [
    "gross_income"
  ],
  "properties": {
    "tax_code": {
      "type": "string",
      "title": "Tax Code",
      "default": "M"
    },
    "tax_year": {
      "type": "string",
      "title": "Tax Year",
      "default": "2026-27"
    },
    "donations": {
      "type": "number",
      "title": "Donations",
      "default": 0
    },
    "gross_income": {
      "type": "number",
      "title": "Gross Income"
    },
    "ietc_eligible": {
      "type": "boolean",
      "title": "Ietc Eligible",
      "default": true
    },
    "months_worked": {
      "type": "number",
      "title": "Months Worked",
      "default": 12
    },
    "paye_deducted": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Paye Deducted",
      "default": null
    },
    "secondary_income": {
      "type": "number",
      "title": "Secondary Income",
      "default": 0
    },
    "secondary_tax_code": {
      "type": "string",
      "title": "Secondary Tax Code",
      "default": "S"
    },
    "acc_included_in_paye": {
      "type": "boolean",
      "title": "Acc Included In Paye",
      "default": true
    },
    "student_loan_deducted": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Student Loan Deducted",
      "default": null
    }
  }
}

Calculate a grade point average for a New Zealand university. Use for any NZ GPA question: 'what is my GPA', 'work out my grade point average from these grades', 'how much will a C drag my GPA down'. CRITICAL: New Zealand uses a NINE POINT scale, not the American 4.0 scale. A+ 9, A 8, A- 7, B+ 6, B 5, B- 4, C+ 3, C 2, C- 1, D and below 0. A GPA of 7.0 is a strong New Zealand result. Do NOT convert to or from a 4.0 scale: the bands do not correspond and any conversion will be wrong. It is credit-weighted, so a grade in a 45 credit paper counts three times a grade in a 15 credit one, and failed papers still count their credits at zero points. Args: courses: One dict per paper, each with "grade" (A+, A, A-, B+, B, B-, C+, C, C-, D+, D, D-, U, F or J) and "credits" (commonly 15). scale: Optional overrides if the institution weights grades differently. Returns: The GPA, the credits and weighted points it came from, and each paper's contribution so the result can be shown rather than asserted.

{
  "type": "object",
  "title": "nz_gpa_calculatorArguments",
  "required": [
    "courses"
  ],
  "properties": {
    "scale": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "title": "Scale",
      "default": null
    },
    "courses": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "title": "Courses"
    }
  }
}

Convert a New Zealand hourly rate into a salary, before and after tax. Use for: 'what is $32 an hour as a salary', 'how much do I take home on $28/hr', 'is $75,000 better than $36 an hour', 'what is my hourly rate really worth after tax'. Gives gross weekly, fortnightly, monthly and annual, then PAYE, ACC, KiwiSaver and student loan, then take-home. Args: hourly_rate: Gross pay per hour in NZD. hours_per_week: Ordinary hours a week. 40 is full time in NZ. weeks_per_year: Weeks actually paid. Use fewer for seasonal or academic work; 52 otherwise. kiwisaver_rate: A DECIMAL, so 0.03 for 3%. Passing 3 is rejected. has_student_loan: Repayments at 12% above the annual threshold. Returns: Gross at each frequency, every deduction, net annual, net weekly, and effective_hourly_after_tax. Note the two weekly figures answer different questions: net_weekly always divides by 52, so it is what arrives each week across the year, while effective_hourly_after_tax uses the hours actually worked. Quote the effective rate when comparing a wage job to a salaried one.

{
  "type": "object",
  "title": "nz_hourly_to_salary_calculatorArguments",
  "required": [
    "hourly_rate"
  ],
  "properties": {
    "hourly_rate": {
      "type": "number",
      "title": "Hourly Rate"
    },
    "hours_per_week": {
      "type": "number",
      "title": "Hours Per Week",
      "default": 40
    },
    "kiwisaver_rate": {
      "type": "number",
      "title": "Kiwisaver Rate",
      "default": 0
    },
    "weeks_per_year": {
      "type": "number",
      "title": "Weeks Per Year",
      "default": 52
    },
    "has_student_loan": {
      "type": "boolean",
      "title": "Has Student Loan",
      "default": false
    }
  }
}

Add up a timesheet of work hours, and turn them into gross pay. Use for: 'how many hours did I work this week', 'add up my shifts', 'what will I be paid for these hours', 'I worked 22:00 to 06:00, how long is that'. Handles overnight shifts: a finish time at or before the start is treated as the next day, so 22:00 to 06:00 is eight hours rather than a negative. Args: days: One dict per day worked, each with "start" and "finish" as "HH:MM" in 24 hour time, optional "break_minutes" of unpaid break, and an optional "label". Leave days off out of the list entirely. hourly_rate: Gross pay per hour. Zero returns hours only. Returns: Hours for each day, the total, and GROSS pay weekly, fortnightly, monthly and annually. For take-home pay use nz_hourly_to_salary_calculator with the rate and the hours. Does not apply overtime or penal rates, public holiday entitlements, or a minimum wage check.

{
  "type": "object",
  "title": "nz_work_hours_calculatorArguments",
  "required": [
    "days"
  ],
  "properties": {
    "days": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "title": "Days"
    },
    "hourly_rate": {
      "type": "number",
      "title": "Hourly Rate",
      "default": 0
    }
  }
}

Work out the tax on a New Zealand bonus or commission, and what is left. Use for: 'how much tax will I pay on my bonus', 'why was my bonus taxed so much', 'what will I actually get from a $10,000 bonus', 'is commission taxed differently'. A bonus is an extra emolument. It is NOT taxed at a flat rate and NOT at the person's ordinary rate. The tax is the difference between tax on (salary + bonus) and tax on salary alone. This is why a bonus so often looks over-taxed and is not: when it straddles a bracket, part is taxed at the lower rate and part at the higher one, so the effective rate sits between them and above the rate on their salary. crosses_bracket tells you when to explain this. ALWAYS ask for the annual salary. The same bonus costs different amounts of tax depending on the salary underneath it, so an answer without it is a guess. Args: bonus_amount: Gross bonus or commission in NZD. annual_salary: Regular annual salary, excluding the bonus. kiwisaver_rate: A DECIMAL, 0.03 for 3%. has_student_loan: Whether repayments are deducted. Returns: Income tax on the bonus, its effective rate, ACC, KiwiSaver, student loan, and the net amount. ACC stops at the earnings cap and student loan only bites above the repayment threshold, both of which are handled. An employer may deduct at a flat rate through the year and let IRD square it up at assessment, so a payslip can differ from this and both be correct.

{
  "type": "object",
  "title": "nz_bonus_tax_calculatorArguments",
  "required": [
    "bonus_amount",
    "annual_salary"
  ],
  "properties": {
    "bonus_amount": {
      "type": "number",
      "title": "Bonus Amount"
    },
    "annual_salary": {
      "type": "number",
      "title": "Annual Salary"
    },
    "kiwisaver_rate": {
      "type": "number",
      "title": "Kiwisaver Rate",
      "default": 0.03
    },
    "has_student_loan": {
      "type": "boolean",
      "title": "Has Student Loan",
      "default": false
    }
  }
}

New Zealand paid parental leave: the payment, and the shortfall. Use for: 'how much is paid parental leave', 'can I afford to take parental leave', 'am I eligible for parental leave', 'how much less will I earn on parental leave'. LEAD YOUR ANSWER WITH THE GAP, not the payment. The payment is capped, so anyone earning over roughly $42,000 receives exactly the cap and already knows that number. What they do not know is weekly_gap and total_gap, how much less arrives and what it adds up to over the leave. That is the figure the decision actually turns on. Eligibility is a gate, not a reduction: 26 weeks of work in the year before the due date, at 10 or more hours a week. Fail either and the payment is zero. ineligible_reason names which test failed and by how much, so say that rather than only "not eligible". Args: annual_income: Gross annual income before tax, in NZD. employment_type: "employee" or "self_employed". Only the self-employed get the statutory weekly minimum. hours_per_week: Average hours a week. weeks_worked: Weeks worked in the 52 before the due date. weeks_of_leave: Weeks of the 26 week entitlement this parent takes. kiwisaver_opt_in: Contributions during leave are OPT IN. Worth raising unprompted: someone who does nothing contributes nothing for the whole period, employer share included. kiwisaver_rate: Employee rate as a decimal. Returns: Weekly and total payment, the weekly and total gap against usual pay, eligibility with a reason, weeks left for a partner, and what opting into KiwiSaver is worth over the leave. IRD administers this and its assessment is the one that counts. Does not cover preterm baby payments, keeping in touch hours, or partner transfers.

{
  "type": "object",
  "title": "nz_parental_leave_calculatorArguments",
  "required": [
    "annual_income"
  ],
  "properties": {
    "weeks_worked": {
      "type": "integer",
      "title": "Weeks Worked",
      "default": 52
    },
    "annual_income": {
      "type": "number",
      "title": "Annual Income"
    },
    "hours_per_week": {
      "type": "number",
      "title": "Hours Per Week",
      "default": 40
    },
    "kiwisaver_rate": {
      "type": "number",
      "title": "Kiwisaver Rate",
      "default": 0.035
    },
    "weeks_of_leave": {
      "type": "integer",
      "title": "Weeks Of Leave",
      "default": 26
    },
    "employment_type": {
      "type": "string",
      "title": "Employment Type",
      "default": "employee"
    },
    "kiwisaver_opt_in": {
      "type": "boolean",
      "title": "Kiwisaver Opt In",
      "default": false
    }
  }
}

Calculate Body Mass Index (BMI) from metric measurements. Returns BMI value, category classification (Underweight, Healthy weight, Overweight, Obese, Morbidly obese), and the healthy weight range for the person's height. Use for any BMI question including 'what is my BMI', 'am I a healthy weight', 'what should I weigh for my height'. Inputs are metric only. If the user provides imperial units (feet, inches, pounds, stone), convert them first: 1 foot = 0.3048m, 1 inch = 0.0254m, 1 pound = 0.453592kg, 1 stone = 6.35029kg. Note: BMI is a screening tool, not a diagnosis. It doesn't distinguish muscle from fat, so very athletic people often show as 'overweight' despite being healthy. Always caveat with this when relevant. Args: weight_kg: Weight in kilograms (e.g. 75 for 75kg). height_m: Height in metres (e.g. 1.75 for 175cm).

{
  "type": "object",
  "title": "bmi_calculatorArguments",
  "required": [
    "weight_kg",
    "height_m"
  ],
  "properties": {
    "height_m": {
      "type": "number",
      "title": "Height M"
    },
    "weight_kg": {
      "type": "number",
      "title": "Weight Kg"
    }
  }
}

Calculate NZ mortgage repayments and lifetime interest totals. Uses the standard amortising-loan PMT formula with monthly compounding. Returns monthly, fortnightly, and weekly repayment figures, total repayments over the life of the loan, total interest paid, and the principal/interest share as percentages. Use for ANY mortgage or home loan question: repayment amounts, affordability checks, comparing loan terms, estimating total interest, or evaluating refinance scenarios. For NZ context: typical NZ mortgage terms are 20-30 years, and rates quoted are annual nominal rates compounded monthly. Most NZ borrowers pay weekly or fortnightly even though rates are quoted monthly. Args: loan_amount: Principal borrowed in NZD (e.g. 650000). annual_interest_rate_pct: Annual rate as a PERCENTAGE not decimal (e.g. 6.5 for 6.5%, NOT 0.065). term_years: Loan term in whole years (typical NZ: 25 or 30).

{
  "type": "object",
  "title": "nz_mortgage_calculatorArguments",
  "required": [
    "loan_amount",
    "annual_interest_rate_pct",
    "term_years"
  ],
  "properties": {
    "term_years": {
      "type": "integer",
      "title": "Term Years"
    },
    "loan_amount": {
      "type": "number",
      "title": "Loan Amount"
    },
    "annual_interest_rate_pct": {
      "type": "number",
      "title": "Annual Interest Rate Pct"
    }
  }
}

Project NZ annual leave balance forward under the Holidays Act 2003. Calculates hours accrued per week based on the holiday pay rate (8% standard NZ minimum), then projects the existing balance forward by the requested future period. Returns projected balance in hours, days, and weeks of equivalent leave. Use for any question about: annual leave accrual, future leave balance, planning time off, calculating entitlement after N months/years of work. NZ context: Holidays Act 2003 mandates minimum 4 weeks paid annual leave per year, which equates to 8% of hours worked accruing as leave. Employers may offer higher rates. Standard NZ full-time week is 40 hours across 5 x 8-hour days. Args: current_balance: Existing leave balance (in hours or days). current_balance_unit: 'hours' or 'days'. Default 'hours'. hours_per_workday: Standard workday length for this person (default 8). holiday_rate_pct: Holiday pay accrual rate (default 8% = NZ minimum). hours_per_workweek: Standard work-week (default 40). future_period: How far forward to project (default 12). future_period_unit: 'weeks', 'months', or 'years' (default 'months').

{
  "type": "object",
  "title": "nz_annual_leave_calculatorArguments",
  "required": [
    "current_balance"
  ],
  "properties": {
    "future_period": {
      "type": "number",
      "title": "Future Period",
      "default": 12
    },
    "current_balance": {
      "type": "number",
      "title": "Current Balance"
    },
    "holiday_rate_pct": {
      "type": "number",
      "title": "Holiday Rate Pct",
      "default": 8
    },
    "hours_per_workday": {
      "type": "number",
      "title": "Hours Per Workday",
      "default": 8
    },
    "future_period_unit": {
      "enum": [
        "weeks",
        "months",
        "years"
      ],
      "type": "string",
      "title": "Future Period Unit",
      "default": "months"
    },
    "hours_per_workweek": {
      "type": "number",
      "title": "Hours Per Workweek",
      "default": 40
    },
    "current_balance_unit": {
      "enum": [
        "hours",
        "days"
      ],
      "type": "string",
      "title": "Current Balance Unit",
      "default": "hours"
    }
  }
}

Project a NZ KiwiSaver balance from current age to retirement age. Month-by-month compound interest projection matching the calculate.co.nz methodology. Includes employee and employer contributions, voluntary top-ups at your chosen cadence, the government contribution ($260.72/yr if eligible), management fees, and PIR tax on investment gains. Returns both the nominal final balance and the inflation-adjusted real (today's dollars) balance. Use for ANY KiwiSaver retirement-planning question: 'how much will I have at 65', 'is $X enough to retire on', 'what happens if I contribute more', 'how much does switching from Conservative to Growth help', 'what's the impact of fees over 30 years'. FUND TYPES and expected annual returns: - Cash: 1.00% (very low risk, low return) - Conservative: 2.50% (low risk, default) - Balanced: 4.00% (moderate risk) - Growth: 7.00% (higher risk, higher expected return) - Custom: you specify via custom_return_pct PIR (Prescribed Investor Rate) is the tax rate on your KiwiSaver investment gains, NOT your income tax rate. Valid values: - 10.5 (low incomes) - 17.5 (middle incomes) - 28 (higher incomes, default) KEY RULES APPLIED (current as of April 2026): - Government contribution: full $260.72/yr for eligible members (halved from $521.43 on 1 July 2025) - Not available if annual income exceeds $179,999.99 - Minimum contribution 3.5% from 1 April 2026 (rising to 4% in 2028) Args: current_balance: Starting KiwiSaver balance in NZD. current_age: Current age in whole years. retirement_age: Projection end age (default 65). annual_income: Current gross annual salary (default 100000). income_growth_pct: Annual salary increase % (default 1.0). employee_rate_pct: 0, 3, 3.5, 4, 6, 8, or 10 (default 3.5). employer_rate_pct: Employer contribution % (default 3.5, NZ minimum). voluntary_amount: Extra contribution per period in NZD (default 0). voluntary_frequency: 'week', 'fortnight', 'month', 'year' (default 'month'). fund_type: Cash, Conservative (default), Balanced, Growth, or Custom. custom_return_pct: Required if fund_type='Custom'. pir_rate_pct: PIR as percentage: 10.5, 17.5, or 28 (default 28). annual_fee_pct: Management fee % annually (default 0.40). inflation_pct: For real-value reporting (default 3.0). switch_fund_at_age: Optional age to switch fund (e.g. derisk at 55). switch_to_fund: Fund to switch to at that age. switch_custom_return_pct: Required if switching to Custom fund.

{
  "type": "object",
  "title": "nz_kiwisaver_calculatorArguments",
  "required": [
    "current_balance",
    "current_age"
  ],
  "properties": {
    "fund_type": {
      "enum": [
        "Cash",
        "Conservative",
        "Balanced",
        "Growth",
        "Custom"
      ],
      "type": "string",
      "title": "Fund Type",
      "default": "Conservative"
    },
    "current_age": {
      "type": "integer",
      "title": "Current Age"
    },
    "pir_rate_pct": {
      "type": "number",
      "title": "Pir Rate Pct",
      "default": 28
    },
    "annual_income": {
      "type": "number",
      "title": "Annual Income",
      "default": 100000
    },
    "inflation_pct": {
      "type": "number",
      "title": "Inflation Pct",
      "default": 3
    },
    "annual_fee_pct": {
      "type": "number",
      "title": "Annual Fee Pct",
      "default": 0.4
    },
    "retirement_age": {
      "type": "integer",
      "title": "Retirement Age",
      "default": 65
    },
    "switch_to_fund": {
      "type": "string",
      "title": "Switch To Fund",
      "default": null
    },
    "current_balance": {
      "type": "number",
      "title": "Current Balance"
    },
    "voluntary_amount": {
      "type": "number",
      "title": "Voluntary Amount",
      "default": 0
    },
    "custom_return_pct": {
      "type": "number",
      "title": "Custom Return Pct",
      "default": null
    },
    "employee_rate_pct": {
      "type": "number",
      "title": "Employee Rate Pct",
      "default": 3.5
    },
    "employer_rate_pct": {
      "type": "number",
      "title": "Employer Rate Pct",
      "default": 3.5
    },
    "income_growth_pct": {
      "type": "number",
      "title": "Income Growth Pct",
      "default": 1
    },
    "switch_fund_at_age": {
      "type": "integer",
      "title": "Switch Fund At Age",
      "default": null
    },
    "voluntary_frequency": {
      "enum": [
        "week",
        "fortnight",
        "month",
        "year"
      ],
      "type": "string",
      "title": "Voluntary Frequency",
      "default": "month"
    },
    "switch_custom_return_pct": {
      "type": "number",
      "title": "Switch Custom Return Pct",
      "default": null
    }
  }
}

Search all 2,377 Calculate.co.nz calculators, guides and datasets by topic. Calculate.co.nz is New Zealand's largest free calculator library. Only a handful of its tools have their own MCP tool; this searches EVERYTHING and returns the pages that match, so any calculation the site covers can be found and linked even when no dedicated tool exists here. Use for ANY question of the form "is there a calculator for...", "how do I work out...", "where can I calculate...", or whenever a New Zealand calculation is asked about and no specific tool above fits. Also use it before telling a user that something cannot be calculated: the site covers tax, mortgages, KiwiSaver, property, employment and leave, business metrics, investments, insurance, vehicles, maths, statistics, science, engineering, health and everyday conversions. Results are ranked with New Zealand specific pages first, because the site is written for NZ rules, rates and legislation. Guides and reference datasets are included alongside calculators, so a question about how something works can return an explanation rather than a form. DO NOT use for: performing the calculation itself when a dedicated tool above exists (use nz_paye_calculator for take-home pay, nz_gst_calculator for GST, nz_mortgage_calculator for repayments, nz_kiwisaver_calculator for KiwiSaver projections, nz_annual_leave_calculator for leave). This tool finds pages; it does not compute. It also cannot answer non-New Zealand questions about foreign tax or benefit systems. Args: query: What the user wants to work out, in plain language. Natural questions work better than keywords: "how much redundancy pay am I owed" beats "redundancy". limit: How many results to return, 1 to 20. Default 5. Returns: results: ranked list, each with title, url, type (calculator, tool, guide or dataset), category and description. Link the url when recommending a page.

{
  "type": "object",
  "title": "find_calculatorArguments",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 5
    },
    "query": {
      "type": "string",
      "title": "Query"
    }
  }
}

Work out the GROSS New Zealand salary needed to take home a given amount. Use for: 'what salary do I need to take home $1,200 a week', 'I want $70,000 in the hand, what do I ask for', 'what gross salary gives me $5,000 a month after tax', negotiating a package to a net figure. This cannot be done by scaling. Tax is progressive and the ACC levy is capped, so the gap between gross and net widens as income rises: doubling the take-home needs more than double the gross. ALWAYS tell the person which deductions were counted. By default the target is treated as after income tax and the ACC earner levy only, which is what the website assumes. If they contribute to KiwiSaver or repay a student loan, pass those, because the gross needed goes up materially. Args: target_net: The take-home wanted, in the period given. period: annual, monthly, fortnightly or weekly. kiwisaver_rate: A DECIMAL, 0.035 for 3.5%. Zero by default. has_student_loan: Whether repayments come out before the target. Returns: The gross needed, the deductions between it and the target, and deductions_included naming exactly what was counted.

{
  "type": "object",
  "title": "nz_net_to_gross_calculatorArguments",
  "required": [
    "target_net"
  ],
  "properties": {
    "period": {
      "type": "string",
      "title": "Period",
      "default": "annual"
    },
    "target_net": {
      "type": "number",
      "title": "Target Net"
    },
    "kiwisaver_rate": {
      "type": "number",
      "title": "Kiwisaver Rate",
      "default": 0
    },
    "has_student_loan": {
      "type": "boolean",
      "title": "Has Student Loan",
      "default": false
    }
  }
}

Work out a New Zealand final pay: leave payout, holidays, notice and redundancy. Use for: 'what should my final pay be', 'how much annual leave am I owed when I leave', 'I am resigning, what do they owe me', 'do I get 8% holiday pay'. ASK HOW LONG THEY WORKED THERE FIRST. It decides the whole calculation: - Under 12 months: no annual holiday entitlement has arisen, so the Holidays Act pays 8% of ALL gross earnings during the employment. Set service="under12" and pass gross_earnings_total. A leave balance showing in a payroll system is NOT what they are owed. - 12 months or more: TWO amounts. The untaken entitlement from completed years (leave_balance_days), PLUS 8% of gross earnings since the last work anniversary (earnings_since_anniversary: ask for it, leaving it out understates), and those earnings include the leave, holidays and notice pay paid out. Set service="over12". leave_balance_days is the ENTITLEMENT that arose at an anniversary and has not been taken. A payslip "leave balance" usually also counts leave accruing since the anniversary, which the 8% already pays for; MBIE says paying out an accrued balance is non-compliant and may underpay. Ask which it is. Also ask about alternative holidays owed, public holidays the untaken entitlement would have covered if taken straight after the last day, and how many days a week they work (days_per_week). Holiday pay already paid in advance or as pay as you go comes off the 8%. Notice pay in lieu counts towards the 8%; redundancy does not unless redundancy_in_eight_percent_base is set (MBIE's position; the courts have not decided it). ALWAYS say what the total leaves out: ordinary wages for days actually worked are paid on top at the usual rate, and every figure is GROSS. The leave payout and any redundancy are taxed as lump sums (extra pays), which is nz_lump_sum_tax_calculator. New Zealand has NO statutory redundancy pay. If they ask what redundancy they are entitled to, the answer is whatever their employment agreement says, and nothing if it says nothing. Args: annual_salary: Annual salary. Give this OR hourly_rate. hourly_rate: Hourly rate, used with hours_per_week. hours_per_week: Ordinary weekly hours, for an hourly rate. service: "over12" or "under12". leave_balance_days: Untaken entitlement from completed years, in days (over12). Not leave accruing since the anniversary. gross_earnings_total: All gross earned, required for under12. average_weekly_earnings: Optional. Leave is paid at the greater of this and ordinary weekly pay; pass it if their pay varied. notice_weeks: Weeks of notice paid in lieu. redundancy: Agreed redundancy from the employment agreement. earnings_since_anniversary: Over12: gross earned since the last anniversary, including final wages, bonus and commission. public_holidays_days: Over12: public holidays the untaken entitlement would have covered (Holidays Act s40). alternative_holidays_days: Alternative holidays not taken. relevant_daily_pay: Optional daily rate for those holidays; weekly pay / days_per_week if not given. holiday_pay_already_paid: Annual holiday pay already paid in advance or as pay as you go. days_per_week: Days worked in a normal week (default 5). redundancy_in_eight_percent_base: Include redundancy in the 8%. Returns: Annual holiday pay (untaken entitlement plus the 8%) with its working shown, public and alternative holidays, notice pay, redundancy, the gross total, and an explicit list of what is excluded.

{
  "type": "object",
  "title": "nz_final_pay_calculatorArguments",
  "properties": {
    "service": {
      "type": "string",
      "title": "Service",
      "default": "over12"
    },
    "redundancy": {
      "type": "number",
      "title": "Redundancy",
      "default": 0
    },
    "hourly_rate": {
      "type": "number",
      "title": "Hourly Rate",
      "default": 0
    },
    "notice_weeks": {
      "type": "number",
      "title": "Notice Weeks",
      "default": 0
    },
    "annual_salary": {
      "type": "number",
      "title": "Annual Salary",
      "default": 0
    },
    "days_per_week": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Days Per Week",
      "default": null
    },
    "hours_per_week": {
      "type": "number",
      "title": "Hours Per Week",
      "default": 40
    },
    "leave_balance_days": {
      "type": "number",
      "title": "Leave Balance Days",
      "default": 0
    },
    "relevant_daily_pay": {
      "type": "number",
      "title": "Relevant Daily Pay",
      "default": 0
    },
    "gross_earnings_total": {
      "type": "number",
      "title": "Gross Earnings Total",
      "default": 0
    },
    "public_holidays_days": {
      "type": "number",
      "title": "Public Holidays Days",
      "default": 0
    },
    "average_weekly_earnings": {
      "type": "number",
      "title": "Average Weekly Earnings",
      "default": 0
    },
    "holiday_pay_already_paid": {
      "type": "number",
      "title": "Holiday Pay Already Paid",
      "default": 0
    },
    "alternative_holidays_days": {
      "type": "number",
      "title": "Alternative Holidays Days",
      "default": 0
    },
    "earnings_since_anniversary": {
      "type": "number",
      "title": "Earnings Since Anniversary",
      "default": 0
    },
    "redundancy_in_eight_percent_base": {
      "type": "boolean",
      "title": "Redundancy In Eight Percent Base",
      "default": false
    }
  }
}

Find the right New Zealand secondary tax code and what it costs. Use for: 'what tax code for my second job', 'is secondary tax a rip off', 'why am I taxed so much on my second job', 'what is SH SL', 'do I get that money back', filling in an IR330. CORRECT THE MISCONCEPTION. A secondary code is not a penalty. It approximates the marginal rate the second income attracts on top of the first, so roughly the right amount comes out through the year, and any excess comes back in the year-end square-up. year_end_position says which way it falls for this person, and a refund is common and normal. The rates look brutal because they are not income tax rates: each carries the 1.75% ACC earner levy, and the SL codes add 12% student loan on top. So 31.75% is 30 plus 1.75, not a 31.75% tax rate. The response breaks the rate into its components; use them when explaining. ALWAYS ask for the main job income. The code depends on the two incomes combined, so an answer without it is a guess. Args: main_income: Gross annual income from the main job. secondary_amount: The second income, in the frequency given. secondary_frequency: annual, monthly, fortnightly or weekly. has_student_loan: Changes the code to its SL variant. Returns: The IR330 code, the flat rate broken into its parts, what is deducted and what is left, and the estimated year-end bill or refund from these two sources.

{
  "type": "object",
  "title": "nz_secondary_tax_calculatorArguments",
  "required": [
    "main_income",
    "secondary_amount"
  ],
  "properties": {
    "main_income": {
      "type": "number",
      "title": "Main Income"
    },
    "has_student_loan": {
      "type": "boolean",
      "title": "Has Student Loan",
      "default": false
    },
    "secondary_amount": {
      "type": "number",
      "title": "Secondary Amount"
    },
    "secondary_frequency": {
      "type": "string",
      "title": "Secondary Frequency",
      "default": "annual"
    }
  }
}

Scale a full-time New Zealand salary to part-time hours, gross and net. Use for: 'what would $90,000 be for 3 days a week', 'pro rata salary for 25 hours', 'I am dropping to four days, what will I earn', 'is part time worth it after tax'. THE USEFUL PART IS THE TAKE-HOME, NOT THE GROSS. The gross scales with the hours; the take-home does not, because dropping hours drops the salary out of the higher brackets. Someone going from five days to three often keeps more than 60% of their take-home, and that is what the decision turns on. Lead with it. The Independent Earner Tax Credit defaults on, because part-time earnings are the band where it is worth the most. Turn it off for someone on a main benefit, Working for Families or NZ Super. Args: full_time_salary: The advertised full-time annual salary. full_time_hours: Hours a week full time is based on, usually 40. your_hours: Hours a week actually worked. kiwisaver_rate: A DECIMAL, 0.035 for 3.5%. has_student_loan: Whether repayments are deducted. claim_ietc: Whether the Independent Earner Tax Credit applies. Returns: The pro rata salary gross by year, month, fortnight and week, the implied hourly rate, and the take-home after tax.

{
  "type": "object",
  "title": "nz_pro_rata_salary_calculatorArguments",
  "required": [
    "full_time_salary"
  ],
  "properties": {
    "claim_ietc": {
      "type": "boolean",
      "title": "Claim Ietc",
      "default": true
    },
    "your_hours": {
      "type": "number",
      "title": "Your Hours",
      "default": 20
    },
    "kiwisaver_rate": {
      "type": "number",
      "title": "Kiwisaver Rate",
      "default": 0.035
    },
    "full_time_hours": {
      "type": "number",
      "title": "Full Time Hours",
      "default": 40
    },
    "full_time_salary": {
      "type": "number",
      "title": "Full Time Salary"
    },
    "has_student_loan": {
      "type": "boolean",
      "title": "Has Student Loan",
      "default": false
    }
  }
}

Tax on a New Zealand redundancy or lump sum, by IRD's rate table. Use for: 'how much tax on my redundancy', 'what will I get from a $40,000 redundancy payment', 'is redundancy taxed differently', 'tax on a retirement payment', checking a redundancy letter. TWO RULES MAKE REDUNDANCY DIFFERENT AND BOTH ARE EASY TO MISS. Redundancy and retirement payments carry NO ACC earner levy, so they always take the lower rate column whatever the income, and NO KiwiSaver is deducted from them at all. Treating a redundancy like a bonus overstates the deductions twice over. Pass payment_type correctly. This applies IRD's published rate TABLE, where annualised income plus the lump sum picks one flat rate charged on the whole payment. That is what an employer deducts on the day. nz_bonus_tax_calculator computes the same tax the exact way instead, which is roughly where the year-end assessment lands. Both are right; they give different answers. Use this one to check a letter or a payslip, and say which method you used. ALWAYS ask for the annual salary. It selects the rate, so the answer depends on it entirely. Args: lump_sum: The gross lump sum in NZD. annual_salary: Annual salary, used as the annualised income. payment_type: redundancy, retirement, bonus, commission, holiday_pay, exit_inducement or back_pay. kiwisaver_rate: A DECIMAL. Forced to zero for redundancy and retirement. has_student_loan: Whether 12% comes off the lump sum. Returns: The rate selected with why_that_rate explaining which row and why, the PAYE, other deductions, and the net amount received.

{
  "type": "object",
  "title": "nz_lump_sum_tax_calculatorArguments",
  "required": [
    "lump_sum",
    "annual_salary"
  ],
  "properties": {
    "lump_sum": {
      "type": "number",
      "title": "Lump Sum"
    },
    "payment_type": {
      "type": "string",
      "title": "Payment Type",
      "default": "redundancy"
    },
    "annual_salary": {
      "type": "number",
      "title": "Annual Salary"
    },
    "kiwisaver_rate": {
      "type": "number",
      "title": "Kiwisaver Rate",
      "default": 0
    },
    "has_student_loan": {
      "type": "boolean",
      "title": "Has Student Loan",
      "default": false
    }
  }
}

Work out a New Zealand family's Working for Families entitlement. Use for: 'how much Working for Families will I get', 'what is my family tax credit', 'do I qualify for the in-work tax credit', 'how much Best Start will I get', 'will I lose Working for Families if I earn more'. CORRECT A COMMON AND EXPENSIVE MISTAKE. There is NO hours test for the In-Work Tax Credit and has not been one since 1 July 2020. Anyone with some income from paid work each week, who is not on an income-tested benefit or student allowance, qualifies. Many sources, including our own website page, still repeat the old 20 hours sole parent / 30 hours couple rule. A parent working fifteen hours a week is entitled to $7,670 this year and is often told they are not. ASK FOR THE COMBINED FAMILY INCOME, not one partner's. Everything abates against it, so an answer from one income is wrong. ASK HOW MANY CHILDREN ARE UNDER 3, not under 1. Best Start runs to the third birthday and is worth $4,041 a year per child. The In-Work Tax Credit is temporarily $7,670 a year until 31 March 2027, then reverts to $5,070, so an answer about next year differs from this one. Say which you have given. Args: children: Dependent children in the caregiver's care. family_income: Combined gross annual family income, all sources. children_under_3: How many are under 3, for Best Start. iwtc_eligible: Some paid work and no income-tested benefit. best_start_children_first_year_exempt: Under-3s in their first year born BEFORE 1 April 2026, which are exempt from the income test. iwtc_after_march_2027: Model the reverted $5,070 rate. Returns: FTC, IWTC and Best Start with each abatement shown separately, the annual, weekly and fortnightly totals, an assumptions block naming every rate used, and what the calculation excludes.

{
  "type": "object",
  "title": "nz_working_for_families_calculatorArguments",
  "required": [
    "children",
    "family_income"
  ],
  "properties": {
    "children": {
      "type": "integer",
      "title": "Children"
    },
    "family_income": {
      "type": "number",
      "title": "Family Income"
    },
    "iwtc_eligible": {
      "type": "boolean",
      "title": "Iwtc Eligible",
      "default": true
    },
    "children_under_3": {
      "type": "integer",
      "title": "Children Under 3",
      "default": 0
    },
    "iwtc_after_march_2027": {
      "type": "boolean",
      "title": "Iwtc After March 2027",
      "default": false
    },
    "best_start_children_first_year_exempt": {
      "type": "integer",
      "title": "Best Start Children First Year Exempt",
      "default": 0
    }
  }
}

Work out New Zealand road user charges for an EV, diesel or plug-in hybrid. Use for: 'how much RUC will I pay', 'what does RUC cost for an EV', 'is a diesel cheaper than petrol once you count RUC', 'do hybrids pay RUC', 'how much are road user charges a year'. GET THE VEHICLE TYPE RIGHT, because it changes the rate: ev $76 per 1,000 km diesel $76 phev_petrol $38, roughly half, because petrol excise is already paid phev_diesel $76, the FULL rate, since diesel carries no excise hybrid_petrol no RUC at all An ordinary petrol hybrid paying nothing is not an exemption: it pays through fuel excise at the pump. Say that rather than implying it escapes. MENTION THE TRANSACTION FEES. RUC is bought in prepaid blocks and every purchase carries a fee, so 20,000 km in 1,000 km blocks pays it twenty times. Buying bigger blocks is the main saving available, and it is invisible if you only multiply distance by rate. petrol_equivalent_excise answers the question underneath most of these: whether the RUC vehicle is really paying more than a petrol one. Light vehicles 3,500 kg and under. Heavy vehicle rates differ and are not covered. Args: annual_km: Distance driven in a year. vehicle_type: ev, diesel, phev_petrol, phev_diesel or hybrid_petrol. block_size_km: Size of each RUC purchase. purchase_method: online or agent. fuel_efficiency_l_per_100km: For the petrol comparison only. Returns: The rate, the charge, the transaction count and fees, the total, cents per kilometre, and the equivalent petrol excise.

{
  "type": "object",
  "title": "nz_road_user_charges_calculatorArguments",
  "required": [
    "annual_km"
  ],
  "properties": {
    "annual_km": {
      "type": "number",
      "title": "Annual Km"
    },
    "vehicle_type": {
      "type": "string",
      "title": "Vehicle Type",
      "default": "diesel"
    },
    "block_size_km": {
      "type": "number",
      "title": "Block Size Km",
      "default": 5000
    },
    "purchase_method": {
      "type": "string",
      "title": "Purchase Method",
      "default": "online"
    },
    "fuel_efficiency_l_per_100km": {
      "type": "number",
      "title": "Fuel Efficiency L Per 100Km",
      "default": 8
    }
  }
}

Estimate a New Zealand household's electricity cost, by region and appliance. Use for: 'how much does power cost in Auckland', 'what does my heat pump cost to run', 'why is my power bill so high', 'is electricity cheaper in Wellington', 'how much does it cost to charge an EV at home'. WHERE THEY LIVE CHANGES THE ANSWER MATERIALLY. Wellington pays 34.61c a unit and Balclutha 48.93c, from MBIE's survey. Ask for the town. LEAD WITH biggest_users. A heat pump and a hot water cylinder dominate almost every bill; standby power almost never does, which is the opposite of where most saving advice points. Naming the two appliances that matter is more useful than the total. MENTION THE FIXED CHARGE. Every connection pays a daily charge whatever it uses, so a low user pays a large share of the bill just for being connected, and a household under 8,000 kWh a year should compare a low fixed charge plan. Those regulations are capped at $1.80 a day from 1 April 2026 and are revoked on 1 April 2027. If they have their bill, pass custom_rate_cents and their own fixed charge rather than the regional average. If they know their own habits, pass appliance_hours: the defaults are a typical household, not theirs. Args: region: An MBIE survey town, or "nz average". household_size: 1 to 5, where 5 means five or more. daily_fixed_charge: In DOLLARS a day, from the bill. custom_rate_cents: Their own rate in cents per kWh including GST. appliance_hours: Override hours, keyed by heat_pump, hot_water, oven, clothes_dryer, ev_charger and the rest. Returns: Daily, monthly and annual cost with usage and fixed charge separated, every appliance costed, the three biggest users, and how the region compares with the national average and the extremes.

{
  "type": "object",
  "title": "nz_electricity_cost_calculatorArguments",
  "properties": {
    "region": {
      "type": "string",
      "title": "Region",
      "default": "nz average"
    },
    "household_size": {
      "type": "integer",
      "title": "Household Size",
      "default": 3
    },
    "appliance_hours": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "title": "Appliance Hours",
      "default": null
    },
    "custom_rate_cents": {
      "type": "number",
      "title": "Custom Rate Cents",
      "default": 0
    },
    "daily_fixed_charge": {
      "type": "number",
      "title": "Daily Fixed Charge",
      "default": 1.5
    }
  }
}

Turn NCEA Level 3 results into a university rank score and a GPA. Use for: 'convert my NCEA to GPA', 'what is my rank score', 'what rank score do I need for engineering', 'NCEA entry score', 'preferential entry score', 'NCEA to 4.0 GPA'. ASK FOR THEIR RESULTS SUBJECT BY SUBJECT and pass `subjects`. The rank score is calculated by the universities that use one, not NZQA. The University of Auckland (rank score), Massey University (Preferential Entry Score, used when places are limited) and the University of Otago (entry score) publish the same method: the best 80 credits over at most five approved subjects, no more than 24 credits from any one subject, Excellence 4, Merit 3, Achieved 2, maximum 320. Totals alone cannot apply those limits, so a totals-only result is an UPPER BOUND (rank_score_is_upper_bound): say so. 40 Excellence in one subject plus 20 Achieved in each of two other subjects is 240 as totals and 176 per subject. Do not say every university uses this. AUT counts the 80 best credits, at most 24 per subject, with no stated five-subject limit, so its score can be higher; the University of Canterbury does not use NCEA rank scores. ANSWER WITH THE RANK SCORE EVEN WHEN THEY ASKED FOR A GPA. The 4-point figure (Excellence 4, Merit 3, Achieved 2, Not Achieved 0, across every credit entered) is indicative and must be labelled unofficial. If they need an official figure for an overseas application, NZQA can provide its own grade point average estimate; tell them to ask NZQA. THE MOST USEFUL THING YOU CAN TELL THEM IS WHY CREDITS DID NOT COUNT: credits_over_subject_cap, credits_not_approved, credits_outside_best_five and credits_outside_best_80. Once 80 credits count, more Achieved credits are worth nothing and lifting existing credits to Merit is worth a great deal. next_step says which case they are in; lead with it. Args: subjects: PREFERRED. A list of {"name": "Calculus", "approved": true, "excellence_credits": 10, "merit_credits": 8, "achieved_credits": 2}, one per Level 3 subject. "approved" means on NZQA's approved list for University Entrance (default true). When given, the three totals below must be 0. excellence_credits: Level 3 Excellence credits as a total (upper bound only). merit_credits: Level 3 Merit credits as a total (upper bound only). achieved_credits: Level 3 Achieved credits as a total (upper bound only). not_achieved_credits: Credits attempted and not achieved, in total; lowers the GPA, never the rank score. Allowed with subjects. Returns: The rank score out of 320 with its working shown, which subjects and credits counted and why the rest did not, an unofficial 4-point GPA, and what would actually raise the score for this student.

{
  "type": "object",
  "title": "nz_ncea_rank_score_calculatorArguments",
  "properties": {
    "subjects": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Subjects",
      "default": null
    },
    "merit_credits": {
      "type": "integer",
      "title": "Merit Credits",
      "default": 0
    },
    "achieved_credits": {
      "type": "integer",
      "title": "Achieved Credits",
      "default": 0
    },
    "excellence_credits": {
      "type": "integer",
      "title": "Excellence Credits",
      "default": 0
    },
    "not_achieved_credits": {
      "type": "integer",
      "title": "Not Achieved Credits",
      "default": 0
    }
  }
}

Work out repayments on a New Zealand car loan, and what it really costs. Use for: 'what would repayments be on a $35,000 car', 'car loan calculator', 'is a 5 year car loan a bad idea', 'how much interest will I pay on car finance'. LEAD WITH interest_share_of_borrowing, NOT THE MONTHLY PAYMENT. Car finance runs at rates a mortgage borrower would not recognise, so over five years the interest often exceeds 30% of what was borrowed. That single figure informs the decision more than the payment does, and it is the one nobody is shown at the dealership. The term is short, so stretching it barely moves the monthly payment and moves the total interest a great deal. If they are considering a longer term, run both and show the difference in total interest. fortnightly_equivalent is the monthly payment converted, because that is how most people are paid. It is NOT fortnightly amortisation, which would clear the loan faster and is a different product. Say which you mean. ALWAYS mention excludes before quoting a payment as what they will pay. Establishment fees, PPSR registration, mechanical breakdown insurance and dealer add-ons are usually financed too, so a real contract is higher. A balloon payment cuts the monthly figure and leaves a lump sum at the end. Args: vehicle_price: Price of the vehicle. deposit: Cash or trade-in up front. annual_interest_rate_pct: A PERCENTAGE, so 12.95 not 0.1295. term_years: Loan term in years. Returns: Monthly, fortnightly and weekly figures, total repaid, total interest, and the interest as a share of the borrowing.

{
  "type": "object",
  "title": "nz_vehicle_loan_calculatorArguments",
  "required": [
    "vehicle_price"
  ],
  "properties": {
    "deposit": {
      "type": "number",
      "title": "Deposit",
      "default": 0
    },
    "term_years": {
      "type": "number",
      "title": "Term Years",
      "default": 5
    },
    "vehicle_price": {
      "type": "number",
      "title": "Vehicle Price"
    },
    "annual_interest_rate_pct": {
      "type": "number",
      "title": "Annual Interest Rate Pct",
      "default": 12.95
    }
  }
}

Work out maintenance calories (TDEE), BMR, and a target for a goal. Use for: 'how many calories should I eat', 'what is my TDEE', 'calorie deficit to lose weight', 'how many calories to lose 5kg', 'what are my macros'. NAME THE FORMULA. Mifflin-St Jeor and the revised Harris-Benedict differ by 5 to 10% for the same person, which is often more than the entire deficit they are trying to run. formula_spread_kcal is that gap and bmr_formula_used says which one the answer took. Quoting a calorie number without saying where it came from is the mistake to avoid here, because the person will treat it as measured rather than estimated. ASK FOR BODY FAT IF THEY MIGHT KNOW IT. With it, Katch-McArdle works from lean mass and is the better estimate, particularly for anyone muscular or carrying more fat than average, where the weight-based formulas are worst. WARN ABOUT THE ACTIVITY LEVEL. Most people overestimate it, and one level is worth several hundred calories a day. One level lower than it feels is usually closer. Projections use 7,700 kcal per kilogram of body fat, so 500 kcal a day is about half a kilogram a week. Pass on the caveats: these are population formulas, not a measurement, and a long timeline runs optimistic because metabolic rate falls as weight does. The honest advice is to eat at the number for two to three weeks and adjust from what the scale does. Args: sex: male or female. It changes the formula constant. age: Years. weight_kg: Body weight in kilograms. height_cm: Height in centimetres. activity_level: sedentary, light, moderate, very_active, extra_active. goal: lose, maintain or gain. body_fat_pct: Optional, and worth asking for. target_weight_kg: Optional, produces a timeline. Returns: All three BMR formulas with their spread, the TDEE, a calorie target for the goal, protein, fat and carbohydrate targets, and a timeline to any target weight.

{
  "type": "object",
  "title": "energy_expenditure_calculatorArguments",
  "required": [
    "sex",
    "age",
    "weight_kg",
    "height_cm"
  ],
  "properties": {
    "age": {
      "type": "integer",
      "title": "Age"
    },
    "sex": {
      "type": "string",
      "title": "Sex"
    },
    "goal": {
      "type": "string",
      "title": "Goal",
      "default": "maintain"
    },
    "height_cm": {
      "type": "number",
      "title": "Height Cm"
    },
    "weight_kg": {
      "type": "number",
      "title": "Weight Kg"
    },
    "body_fat_pct": {
      "type": "number",
      "title": "Body Fat Pct",
      "default": 0
    },
    "activity_level": {
      "type": "string",
      "title": "Activity Level",
      "default": "moderate"
    },
    "target_weight_kg": {
      "type": "number",
      "title": "Target Weight Kg",
      "default": 0
    }
  }
}

Work out New Zealand fringe benefit tax on a company vehicle, a low-interest loan, or another benefit. Use for: 'FBT on a company car', 'how much FBT do I pay', 'fringe benefit tax calculator', 'is the alternate rate cheaper', 'FBT on a staff loan'. THE RATE IS THE EASY PART. What goes wrong is the taxable value, because FBT is charged on a value derived from the asset, not on what the benefit cost the employer. For a vehicle the two methods give very different answers on the same car. Cost price is 5% a quarter of the GST-inclusive price the employer paid and NEVER FALLS as the car ages. Tax book value is 9% a quarter of the written-down value, with a floor of $8,333. An older vehicle is usually cheaper on tax book value; a cheap one can be dearer, because of the floor. If someone is choosing, run both. THE DAYS DIVISOR IS ALWAYS 90, under section RD 29(5)(a) of the Income Tax Act 2007. It is not the number of days in the actual quarter. Do not "correct" it to 91 or 92. On the rate, be careful: 63.93% is the single rate, applies to every employee whatever they earn, and needs no wash-up. 49.25% is lower but available in quarters one to three ONLY, and using it obliges a quarter four wash-up that can claw the saving back. NEVER present the alternate rate as simply cheaper. quarter_four_washup_required says so for you. annual_fbt is the quarter times four, which holds only if the benefit is unchanged all year. A car bought mid-year is not. Args: benefit_type: 'vehicle', 'loan' or 'other'. rate_method: 'single' (63.93%) or 'alternate' (49.25%). vehicle_value: Vehicle only. GST-inclusive cost price or tax book value. value_method: 'cost_price' or 'tax_book_value'. days_available: Vehicle only. Days available for private use, capped at 90. employee_contribution: Vehicle only. What the employee paid this quarter. loan_balance: Loan only. Average balance for the quarter. prescribed_rate_pct: Loan only. IRD prescribed rate, as a percentage. actual_rate_pct: Loan only. Rate actually charged, as a percentage. other_quarterly_value: Other benefits only. Quarterly taxable value. Returns: Quarterly taxable value, the rate applied, quarterly and annual FBT, whether a quarter four wash-up is required, and the working.

{
  "type": "object",
  "title": "nz_fbt_calculatorArguments",
  "properties": {
    "rate_method": {
      "type": "string",
      "title": "Rate Method",
      "default": "single"
    },
    "benefit_type": {
      "type": "string",
      "title": "Benefit Type",
      "default": "vehicle"
    },
    "loan_balance": {
      "type": "number",
      "title": "Loan Balance",
      "default": 0
    },
    "value_method": {
      "type": "string",
      "title": "Value Method",
      "default": "cost_price"
    },
    "vehicle_value": {
      "type": "number",
      "title": "Vehicle Value",
      "default": 0
    },
    "days_available": {
      "type": "number",
      "title": "Days Available",
      "default": 90
    },
    "actual_rate_pct": {
      "type": "number",
      "title": "Actual Rate Pct",
      "default": 0
    },
    "prescribed_rate_pct": {
      "type": "number",
      "title": "Prescribed Rate Pct",
      "default": 0
    },
    "employee_contribution": {
      "type": "number",
      "title": "Employee Contribution",
      "default": 0
    },
    "other_quarterly_value": {
      "type": "number",
      "title": "Other Quarterly Value",
      "default": 0
    }
  }
}

Work out what is actually owed when a New Zealand role is made redundant. Use for: 'what redundancy am I entitled to', 'redundancy pay NZ', 'made redundant what do I get', 'is redundancy pay compulsory in New Zealand'. START WITH THIS, BECAUSE IT IS THE MOST COMMON ERROR IN GENERAL ADVICE: NEW ZEALAND HAS NO STATUTORY REDUNDANCY PAY. None. An employee is entitled to redundancy compensation ONLY if their employment agreement provides for it. This is the opposite of the UK and Australian position, and answers written from overseas sources get it wrong. The default clause here is "none" for that reason, and statutory_position says it in words. What IS owed by law is the mandatory side: wages worked and unpaid, annual leave not taken, alternative holidays not taken, and the notice period. TWO TOTALS COME BACK AND THEY ANSWER DIFFERENT QUESTIONS. total_all_in everything the person receives. The SAME figure whether notice is worked or paid in lieu. Quote this when someone asks what they will get. total_package the final pay only. Quote this when they are asking about the payslip. They differ because notice worked arrives as ordinary salary over those weeks rather than as a lump sum. Quoting only the final pay makes payment in lieu look better off by a whole notice period, which it is not. Every figure is GROSS. Redundancy compensation is an extra pay taxed at the lump sum rate, so use nz_lump_sum_tax_calculator for the tax on it. If they do not know whether they have a clause, tell them to check the employment agreement, and any collective agreement or company policy it refers to, before concluding they are owed nothing. Args: annual_salary: Gross annual salary. years_of_service: Completed years. Part years are not counted. notice_weeks: Notice period in weeks. notice_worked: True if worked, False if paid in lieu. annual_leave_days: Days accrued and not taken. alternative_holiday_days: Days in lieu not taken. redundancy_clause: 'none', '2_weeks', '3_weeks', '4_weeks', 'fixed_4', 'fixed_8', 'fixed_13' or 'custom'. custom_redundancy_amount: Used only with 'custom'. outstanding_wages: Wages worked and not yet paid. Returns: Mandatory entitlements and contractual compensation kept apart, the final pay, and the all-in total.

{
  "type": "object",
  "title": "nz_redundancy_entitlement_calculatorArguments",
  "required": [
    "annual_salary"
  ],
  "properties": {
    "notice_weeks": {
      "type": "integer",
      "title": "Notice Weeks",
      "default": 4
    },
    "annual_salary": {
      "type": "number",
      "title": "Annual Salary"
    },
    "notice_worked": {
      "type": "boolean",
      "title": "Notice Worked",
      "default": true
    },
    "years_of_service": {
      "type": "integer",
      "title": "Years Of Service",
      "default": 0
    },
    "annual_leave_days": {
      "type": "number",
      "title": "Annual Leave Days",
      "default": 0
    },
    "outstanding_wages": {
      "type": "number",
      "title": "Outstanding Wages",
      "default": 0
    },
    "redundancy_clause": {
      "type": "string",
      "title": "Redundancy Clause",
      "default": "none"
    },
    "alternative_holiday_days": {
      "type": "number",
      "title": "Alternative Holiday Days",
      "default": 0
    },
    "custom_redundancy_amount": {
      "type": "number",
      "title": "Custom Redundancy Amount",
      "default": 0
    }
  }
}

Work out a weekly grocery budget for a New Zealand household. Use for: 'how much should I spend on groceries', 'grocery budget for a family of four NZ', 'average food bill New Zealand', 'am I spending too much on food'. Build the household person by person. A teenager is not a child-sized cost, and an average per head hides exactly the thing that makes the answer useful. Member types are child_5_10, teen_11_17, adult_male, adult_female and elderly_65; list one entry per person. ALL THREE SPEND LEVELS COME BACK EVERY TIME, and that is the point. A single figure invites "that seems high". The gap between basic and liberal for the SAME household, in dollars a year, is the number that changes behaviour, and on a family of four it is usually several thousand dollars. annual_gap_basic_to_liberal puts it in one place. Lead with it. BE STRAIGHT ABOUT WHAT THESE FIGURES ARE. They are indicative planning figures, not measured survey data and not a benchmark to hold anyone to. Do not present them as official. If someone wants measured New Zealand data, point them at the Household Economic Survey pages on the site instead. Args: members: One entry per person, e.g. ['adult_male', 'adult_female', 'teen_11_17']. Between one and twelve. spend_level: 'basic', 'moderate' or 'liberal'. diet: 'standard', 'vegetarian', 'vegan', 'gluten_free', 'organic' or 'halal'. region: 'nz_average', 'auckland', 'wellington', 'christchurch', 'hamilton', 'tauranga', 'dunedin', 'provincial' or 'rural_remote'. include_non_food: Add $25 a week for cleaning products and toiletries. Returns: Weekly, monthly and annual budgets, all three spend levels, the annual gap between them, and the per-person weekly figure.

{
  "type": "object",
  "title": "nz_grocery_budget_calculatorArguments",
  "required": [
    "members"
  ],
  "properties": {
    "diet": {
      "type": "string",
      "title": "Diet",
      "default": "standard"
    },
    "region": {
      "type": "string",
      "title": "Region",
      "default": "nz_average"
    },
    "members": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "title": "Members"
    },
    "spend_level": {
      "type": "string",
      "title": "Spend Level",
      "default": "moderate"
    },
    "include_non_food": {
      "type": "boolean",
      "title": "Include Non Food",
      "default": true
    }
  }
}

Compare contracting with salaried employment in New Zealand, on what is actually kept. Use for: 'should I go contracting', 'contractor rate vs salary', 'what rate do I need to match my salary', 'is contracting worth it NZ'. ALMOST EVERYONE COMPARES THE TWO HEADLINE NUMBERS AS THOUGH THEY WERE THE SAME KIND OF NUMBER. They are not. An employee's package includes things a contractor has to fund out of the rate: - Employer KiwiSaver, at least 3.5% from 1 April 2026, less ESCT. A contractor gets no match, so the same percentage costs them all of it. - Annual leave, ten sick days and eleven public holidays. Around 45 of the 260 working days in a year. - The ACC work levy, which an employer pays and a contractor does not. SO TWO COMPARISONS COME BACK. cash_difference is take-home against take-home, and it is the one that FLATTERS CONTRACTING because it ignores all of the above. package_difference is the honest one. It is common for a contract to be well ahead on cash and behind on package. If you quote only the first you have given bad advice, so quote both and say which is which. breakeven_contract_income answers the question people actually have, which is what they need to charge to be no worse off. Lead with it when someone is deciding on a rate. annual_contract_income is the year's TOTAL invoicing, not a rate to be multiplied up. billable_weeks only expresses the implied weekly and daily rate. GST is excluded: over $60,000 of turnover registration is compulsory, but GST is collected and passed on rather than earned. Also worth saying out loud, because it has no dollar figure and is not nothing: an employee has notice periods and personal grievance rights, and a contractor does not. Args: annual_gross_salary: The salaried offer, gross. annual_contract_income: Total expected to invoice for the year, GST exclusive. annual_business_expenses: Deductible expenses for the year. billable_weeks: Weeks expected to bill. Used only for the implied rate. acc_work_levy_pct: ACC work levy as a percentage. Varies a lot by industry. employer_kiwisaver_rate_pct: Employer contribution, minimum 3.5%. own_kiwisaver_rate_pct: Their own rate, applied to both sides. annual_leave_days: Annual leave in the employment offer. has_student_loan: Applies to both sides. claim_ietc: Whether the independent earner tax credit is claimable. Returns: Both sides costed line by line, the difference on cash and on package, which wins on each, and the breakeven contract income.

{
  "type": "object",
  "title": "nz_contractor_vs_employee_calculatorArguments",
  "required": [
    "annual_gross_salary",
    "annual_contract_income"
  ],
  "properties": {
    "claim_ietc": {
      "type": "boolean",
      "title": "Claim Ietc",
      "default": true
    },
    "billable_weeks": {
      "type": "number",
      "title": "Billable Weeks",
      "default": 46
    },
    "has_student_loan": {
      "type": "boolean",
      "title": "Has Student Loan",
      "default": false
    },
    "acc_work_levy_pct": {
      "type": "number",
      "title": "Acc Work Levy Pct",
      "default": 0.7
    },
    "annual_leave_days": {
      "type": "number",
      "title": "Annual Leave Days",
      "default": 20
    },
    "annual_gross_salary": {
      "type": "number",
      "title": "Annual Gross Salary"
    },
    "annual_contract_income": {
      "type": "number",
      "title": "Annual Contract Income"
    },
    "own_kiwisaver_rate_pct": {
      "type": "number",
      "title": "Own Kiwisaver Rate Pct",
      "default": 3.5
    },
    "annual_business_expenses": {
      "type": "number",
      "title": "Annual Business Expenses",
      "default": 0
    },
    "employer_kiwisaver_rate_pct": {
      "type": "number",
      "title": "Employer Kiwisaver Rate Pct",
      "default": 3.5
    }
  }
}

Estimate a New Zealand main benefit, its abatement and the Accommodation Supplement that goes with it. Use for: 'how much is jobseeker', 'sole parent support rate', 'supported living payment amount', 'how much can I earn before my benefit is cut', 'accommodation supplement how much', 'winter energy payment'. FOUR THINGS DECIDE THE ANSWER AND ONLY THE FIRST IS WIDELY KNOWN. The base rate depends on the benefit and the living situation. ABATEMENT IS NOT A DOLLAR FOR DOLLAR CUT. The first $160 a week of other income is free. Above that a sole parent loses 30c in the dollar up to $250 and 70c after; everyone else loses 70c from the start. People routinely believe every dollar earned is a dollar lost and turn down work on that basis, so if someone is asking whether it is worth working, say the free zone exists and how big it is. THE ACCOMMODATION SUPPLEMENT IS 70% OF HOUSING COSTS ABOVE AN ENTRY THRESHOLD, not 70% of the rent. The threshold is 25% of the base rate for renters and boarders and 30% for owners, and only 62% of a board payment counts as a housing cost at all. It is then capped by area, 1 being the highest cost. Someone whose rent is below the threshold gets nothing. The Winter Energy Payment runs 1 May to 1 October and is only paid while some main benefit is still payable after abatement. Rates are read from the published register, and rate_source says which figure was used, when it was verified and when it next changes. Benefit rates move every 1 April, so do not reuse an answer across that date. THIS IS AN ESTIMATE OF PUBLISHED RATES, NOT AN ASSESSMENT. Entitlement also depends on residency, relationship status, assets and obligations no calculator sees. Say so rather than presenting it as a decision. Args: benefit_type: Which main benefit is being received. situation: Living situation, which selects the weekly rate. weekly_income: Other gross weekly income before tax. accommodation_cost: Weekly rent, board or ownership cost. housing_type: rent, board or mortgage. Board counts at 62%. area: Accommodation Supplement area, 1 to 4. Area 1 is highest cost. children: Number of dependent children. winter: Whether the Winter Energy Payment period applies. Returns: The weekly entitlement step by step: base rate, abatement, supplement with its cap and entry threshold, winter payment and the total.

{
  "type": "object",
  "title": "nz_benefit_entitlement_calculatorArguments",
  "properties": {
    "area": {
      "type": "integer",
      "title": "Area",
      "default": 2
    },
    "winter": {
      "type": "boolean",
      "title": "Winter",
      "default": false
    },
    "children": {
      "type": "integer",
      "title": "Children",
      "default": 0
    },
    "situation": {
      "enum": [
        "single_25",
        "single_20_24",
        "single_18_19_away",
        "single_18_19_home",
        "couple_no_children",
        "couple_children",
        "sole_parent"
      ],
      "type": "string",
      "title": "Situation",
      "default": "single_25"
    },
    "benefit_type": {
      "enum": [
        "jobseeker",
        "sole_parent",
        "supported_living"
      ],
      "type": "string",
      "title": "Benefit Type",
      "default": "jobseeker"
    },
    "housing_type": {
      "enum": [
        "rent",
        "board",
        "mortgage"
      ],
      "type": "string",
      "title": "Housing Type",
      "default": "rent"
    },
    "weekly_income": {
      "type": "number",
      "title": "Weekly Income",
      "default": 0
    },
    "accommodation_cost": {
      "type": "number",
      "title": "Accommodation Cost",
      "default": 0
    }
  }
}

Work out the withholding tax on a New Zealand schedular payment to a contractor, and what the contractor is actually left with. Use for: 'withholding tax on contractor payment', 'schedular payment tax rate', 'IR330C rate', 'director fee tax NZ', 'what tax do I deduct from a contractor', 'no IR330C what rate'. TWO RULES CAUSE MOST OF THE TROUBLE. WITHHOLDING TAX IS CHARGED ON THE PAYMENT EXCLUDING GST. A GST registered contractor invoicing $1,000 plus GST bills $1,150, and the withholding is charged on the $1,000. Charging it on the GST-inclusive figure over-deducts by 15% of the tax every single time, and it is a common payroll error. THE RATE DEPENDS ON THE ACTIVITY, NOT ON THE CONTRACTOR. Schedule 4 sets a standard rate per listed activity. A contractor may elect anything between 10% and 40% on an IR330C. WITHOUT THAT FORM THE PAYER MUST DEDUCT AT 45%, the no-notification rate, which is punitive by design and catches people who simply never sent the paperwork back. If someone is being deducted 45%, the fix is usually a form, not an argument. THE DEDUCTION IS NOT A FINAL TAX. It is a credit against the contractor's income tax for the year, so a contractor with deductible expenses usually gets some back and one with a large profit usually owes more. year_end_credit is the figure that goes in the return. Do not describe the deduction as "the tax they paid on that job". Args: payment_excluding_gst: The fee BEFORE GST. activity: Schedule 4 activity, which sets the standard rate. rate_option: standard, nominated (an IR330C election), or no_form. nominated_rate_pct: The elected rate, 10 to 40. Required for nominated. gst_registered: Whether the contractor is GST registered. Returns: The invoice, the rate and why it applies, the tax deducted, the net to the contractor, and the credit claimable at year end.

{
  "type": "object",
  "title": "nz_schedular_payment_calculatorArguments",
  "required": [
    "payment_excluding_gst"
  ],
  "properties": {
    "activity": {
      "enum": [
        "company_directors",
        "public_office",
        "sports",
        "commission",
        "entertainers_resident",
        "modelling",
        "cleaners",
        "forestry",
        "horticultural",
        "shearers",
        "labour_hire",
        "entertainers_non_resident",
        "standard_default"
      ],
      "type": "string",
      "title": "Activity",
      "default": "standard_default"
    },
    "rate_option": {
      "enum": [
        "standard",
        "nominated",
        "no_form"
      ],
      "type": "string",
      "title": "Rate Option",
      "default": "standard"
    },
    "gst_registered": {
      "type": "boolean",
      "title": "Gst Registered",
      "default": false
    },
    "nominated_rate_pct": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Nominated Rate Pct",
      "default": null
    },
    "payment_excluding_gst": {
      "type": "number",
      "title": "Payment Excluding Gst"
    }
  }
}

Estimate what ACC pays each week while an injury stops someone working. Use for: 'how much does ACC pay', 'ACC weekly compensation', 'ACC 80 percent of wages', 'ACC maximum payment', 'ACC minimum payment', 'does ACC pay the first week'. "80% OF YOUR EARNINGS" IS THE HEADLINE AND IT IS INCOMPLETE THREE WAYS. THE FIRST WEEK IS THE EMPLOYER'S COST, NOT ACC'S. ACC starts from the second week. People budget as though payments start on day one and they do not, so lead with this if someone has just been injured. THERE IS A CEILING. Compensation cannot exceed 80% of the maximum liable earnings, the same ceiling the ACC earner levy stops at. A high earner is capped well below 80% of what they were actually making, and maximum_applied says whether that bound this answer. THERE IS A FLOOR, BUT ONLY FOR FULL-TIME EARNERS, meaning 30 hours a week or more. It is 80% of the adult minimum wage for a 40 hour week. A part-timer on low earnings is NOT lifted to it. This is the one most often assumed the other way round. Both bounds are derived from the rate register rather than typed, so they move on 1 April with the levy ceiling and the minimum wage. The short-term basis uses the four weeks before the injury and applies for the first four weeks; after that ACC moves to a 52 week basis, which matters a great deal for anyone with irregular or seasonal earnings. This is an estimate on published settings, not a decision on any claim. Entitlement depends on cover being accepted and an assessed incapacity. Args: weekly_earnings: Gross weekly earnings before the injury. hours_per_week: Hours normally worked. 30 or more is full time. basis: short_term for the first four weeks, long_term after. Returns: The weekly payment, the uncapped 80% figure, both bounds, whether either applied, and what the employer pays for the first week.

{
  "type": "object",
  "title": "nz_acc_weekly_compensation_calculatorArguments",
  "required": [
    "weekly_earnings"
  ],
  "properties": {
    "basis": {
      "enum": [
        "short_term",
        "long_term"
      ],
      "type": "string",
      "title": "Basis",
      "default": "short_term"
    },
    "hours_per_week": {
      "type": "number",
      "title": "Hours Per Week",
      "default": 40
    },
    "weekly_earnings": {
      "type": "number",
      "title": "Weekly Earnings"
    }
  }
}

Work out a New Zealand sick leave entitlement and the balance left. Use for: 'how much sick leave do I get NZ', 'sick leave entitlement', 'when do I get sick leave', 'can I carry over sick leave', 'sick leave balance', 'ten days sick leave'. THREE RULES, AND TWO OF THEM ARE CAPS PEOPLE FORGET UNTIL THEY COLLIDE. ENTITLEMENT STARTS AFTER SIX MONTHS of continuous employment, then ten days on each anniversary. Nothing accrues day by day before that, so an employee at five months has no statutory entitlement at all. This surprises people who assume leave builds up from day one the way annual leave does. CARRY-OVER IS CAPPED AT TEN DAYS. An employee who took none last year carries ten, not everything they were owed. THE TOTAL IS CAPPED AT TWENTY DAYS. Ten current plus ten carried is the statutory maximum. capped_by_carry_over_limit and capped_by_total_limit say which cap, if either, bound the answer, because "why is my balance not what I counted" is almost always one of those two. Give daily_pay to value the balance. Relevant daily pay is what the employee would have earned on the day taken, which is not necessarily salary divided by 260, so treat the valuation as indicative. This is the statutory minimum under the Holidays Act 2003. An employment agreement may be more generous, and extra_contractual_days is where that goes. Args: start_date: Employment start date, ISO format YYYY-MM-DD. as_at: Date to calculate at, ISO format. Defaults to today. days_taken: Days taken in the current entitlement year. carry_over_days: Unused days offered from last year, before the cap. extra_contractual_days: Days above the statutory ten in the agreement. daily_pay: Relevant daily pay, to value the balance. Optional. Returns: Months employed, whether entitled yet, the entitlement, carry-over before and after the cap, days taken, the balance and which caps bound it.

{
  "type": "object",
  "title": "nz_sick_leave_calculatorArguments",
  "required": [
    "start_date"
  ],
  "properties": {
    "as_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "As At",
      "default": null
    },
    "daily_pay": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Daily Pay",
      "default": null
    },
    "days_taken": {
      "type": "number",
      "title": "Days Taken",
      "default": 0
    },
    "start_date": {
      "type": "string",
      "title": "Start Date"
    },
    "carry_over_days": {
      "type": "number",
      "title": "Carry Over Days",
      "default": 0
    },
    "extra_contractual_days": {
      "type": "integer",
      "title": "Extra Contractual Days",
      "default": 0
    }
  }
}

Pick the correct New Zealand tax code for an IR330, and explain why. Use for: 'what tax code should I use', 'M or ME tax code', 'secondary tax code NZ', 'SB S SH ST SA which one', 'tax code for second job', 'am I on the wrong tax code'. THE WRONG CODE IS ONE OF THE FEW PAYROLL MISTAKES THAT COSTS MONEY QUIETLY ALL YEAR, and there are two ways to get it wrong. A SECONDARY CODE IS CHOSEN ON TOTAL INCOME ACROSS ALL JOBS, NOT ON WHAT THE SECOND JOB PAYS. Someone earning $60,000 in a main job and $8,000 in a second is SH, not SB. Choosing on the smaller figure under-taxes and produces a bill at year end. ALWAYS ASK FOR TOTAL INCOME before answering a secondary code question. If total_income_all_jobs is omitted this falls back to this job's income and returns a warning saying the band is very likely wrong; pass that warning on rather than reporting the code as settled. ME IS NOT SIMPLY "M PLUS A CREDIT". The Independent Earner Tax Credit, worth up to $520 a year, is withdrawn by receiving Working for Families, a main benefit or NZ Super, so someone inside the $24,000 to $70,000 band can still correctly be an M. Add SL when a student loan is being repaid. On a SECONDARY job the repayment is 12% of the gross with no threshold at all, because the repayment threshold belongs to the main job. That catches people who expect the threshold twice. Special tax codes, non-resident status and multiple secondary jobs are out of scope here; those need Inland Revenue. Args: annual_income: Income from THIS job, before tax. job_type: primary for the main job, secondary for any other. total_income_all_jobs: Total across every job. Needed for secondary. has_student_loan: Whether a student loan is being repaid. receives_wff_benefit_or_super: Working for Families, a main benefit or NZ Super. Any of these removes IETC eligibility. Returns: The code, what it means, why it applies rather than the alternative, the flat rate for a secondary code, and any warning about the inputs.

{
  "type": "object",
  "title": "nz_tax_code_calculatorArguments",
  "required": [
    "annual_income"
  ],
  "properties": {
    "job_type": {
      "enum": [
        "primary",
        "secondary"
      ],
      "type": "string",
      "title": "Job Type",
      "default": "primary"
    },
    "annual_income": {
      "type": "number",
      "title": "Annual Income"
    },
    "has_student_loan": {
      "type": "boolean",
      "title": "Has Student Loan",
      "default": false
    },
    "total_income_all_jobs": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Total Income All Jobs",
      "default": null
    },
    "receives_wff_benefit_or_super": {
      "type": "boolean",
      "title": "Receives Wff Benefit Or Super",
      "default": false
    }
  }
}

Work out when a New Zealand employer must pay PAYE and file the pay run. Use for: 'when is PAYE due', 'PAYE payment dates', 'payday filing deadline', 'employer tax due date NZ', 'do I pay PAYE twice a month', 'PAYE due date falls on a weekend'. PAYING AND FILING ARE DIFFERENT DEADLINES and missing either has its own consequences. Answer both, and say which is which. Payday filing is due within TWO WORKING DAYS of the payday itself. The payment is due on the 20th of the following month for a monthly payer, or on the 20th and the 5th for a twice-monthly payer. WHICH PAYER YOU ARE IS DECIDED BY PAYE PLUS ESCT SENT TO INLAND REVENUE OVER THE PRIOR TWELVE MONTHS, not by the size of the payroll and not by headcount. The threshold is $500,000 of DEDUCTIONS. A business paying $2m in wages is usually still a monthly payer, so never infer the payer type from turnover or staff numbers; ask for the deductions figure. Both dates shift off weekends and national public holidays including Mondayised ones. Where a shift happened, payment_due_shifted_from and payday_filing_due_shifted_from show what it moved from, so the answer can be checked rather than taken on trust. Regional anniversary days do NOT move a PAYE date and are deliberately excluded. paper_filing_due comes back every time because paper filers work to a different rule, ten days from the end of the month. Holiday dates are held for 2026 and 2027 only. Outside those years this returns an error rather than guessing, because a due date computed against holidays nobody checked is worse than no answer. Args: pay_date: The date employees are PAID, ISO format YYYY-MM-DD. The payday, not the end of the pay period. annual_paye_and_esct: PAYE plus ESCT over the prior 12 months. electronic_filer: Whether payday filing is electronic. Returns: Payer type and why, the payment due date, the payday filing due date, what either was shifted from, and the paper filing deadline.

{
  "type": "object",
  "title": "nz_paye_due_dates_calculatorArguments",
  "required": [
    "pay_date"
  ],
  "properties": {
    "pay_date": {
      "type": "string",
      "title": "Pay Date"
    },
    "electronic_filer": {
      "type": "boolean",
      "title": "Electronic Filer",
      "default": true
    },
    "annual_paye_and_esct": {
      "type": "number",
      "title": "Annual Paye And Esct",
      "default": 0
    }
  }
}

Depreciate an asset by straight line or diminishing value, with a year by year schedule. Use for: 'how is depreciation calculated', 'straight line vs diminishing value', 'depreciation schedule', 'book value after 3 years', 'work out depreciation on equipment'. THE TWO METHODS DIVERGE SHARPLY ON THE SAME ASSET. Straight line spreads the deduction evenly across the useful life. Diminishing value applies the rate to the REDUCING book value, so it front-loads the deduction heavily and never reaches zero on its own. Which is better depends entirely on when the owner wants the deduction, so the year by year schedule is the useful part of this answer rather than the first year figure. Show the schedule. additional_costs are capitalised into the cost base, which is where delivery and installation belong. salvage_value acts as a floor under both methods, and the last year of a straight line life takes only what is left, so rounding cannot push the book value below it. ONE IMPORTANT LIMIT, AND IT MATTERS. This is the ARITHMETIC of the two methods on a rate you supply. It is NOT a lookup of Inland Revenue's prescribed rates, which vary by asset class and are published in the IRD depreciation rate finder. If someone needs to know the right RATE for a particular asset, send them to that finder. DO NOT INVENT A RATE to feed this tool and present the output as their tax position. Args: initial_cost: Purchase price of the asset. method: straight_line or diminishing_value. additional_costs: Costs capitalised in, such as delivery or installation. salvage_value: Expected residual value. A floor under both methods. useful_life_years: Years of life. Required for straight line. annual_rate_pct: Rate per year. Required for diminishing value. years_to_schedule: Years to show. Defaults to the life, or ten. Returns: The cost base, the depreciable amount, the first year charge, the total charged, the closing book value and the full year by year schedule.

{
  "type": "object",
  "title": "depreciation_calculatorArguments",
  "required": [
    "initial_cost"
  ],
  "properties": {
    "method": {
      "enum": [
        "straight_line",
        "diminishing_value"
      ],
      "type": "string",
      "title": "Method",
      "default": "straight_line"
    },
    "initial_cost": {
      "type": "number",
      "title": "Initial Cost"
    },
    "salvage_value": {
      "type": "number",
      "title": "Salvage Value",
      "default": 0
    },
    "annual_rate_pct": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Annual Rate Pct",
      "default": null
    },
    "additional_costs": {
      "type": "number",
      "title": "Additional Costs",
      "default": 0
    },
    "useful_life_years": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Useful Life Years",
      "default": null
    },
    "years_to_schedule": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Years To Schedule",
      "default": null
    }
  }
}

Give the New Zealand minimum wage in force on a date, the pay for given hours, and the take-home after PAYE, ACC, KiwiSaver and student loan. Use for: 'what is the minimum wage nz', 'minimum wage 2026', 'minimum wage take home pay', 'starting out wage', 'training wage nz', 'minimum wage per week', 'what was the minimum wage in 2020', 'youth rates nz'. THREE RATES, TWO OF THEM THE SAME. Adult is $23.95 an hour from 1 April 2026. Starting-out and training are both 80% of the adult rate, $19.16. Per Employment New Zealand, starting-out covers three groups: 16 and 17 year olds who have not worked 6 continuous months for their current employer; 16 to 19 year olds whose employment agreement requires at least 40 credits a year of industry training; and 18 and 19 year olds paid a specified benefit for 6 months or more who have not since worked 6 continuous months for one employer. Training covers those 20 and over whose agreement requires at least 60 credits a year of industry training, usually apprentices. Neither applies to anyone supervising or training other workers. Before 1 May 2013 the 80% rate was the new entrant rate, and rate_name says so. THE RATE CHANGES EACH 1 APRIL. In March the rate in force is last year's. Give as_at to answer for any date from 1 April 2008. TAKE-HOME IS ON CURRENT SETTINGS ONLY, so for a past date the take_home field is null and only the rate and gross pay are given. Tax code M does not claim the IETC: 40 hours at $23.95 nets $761.06 a week on M, $771.06 on ME. Args: wage_type: adult, starting_out, training, living_wage or custom. hours_per_week: Hours worked a week, more than 0 and at most 168. custom_rate: Hourly rate, required when wage_type is custom. kiwisaver_rate: Employee rate as a fraction (0.035 for 3.5%), or 0. student_loan: Whether a student loan is being repaid. tax_code: M, or ME for someone eligible for the IETC. as_at: Date to answer for, ISO YYYY-MM-DD. Defaults to today in NZ. Returns: The rate applied and its effective date, the adult, starting-out and training rates on that date, gross weekly, fortnightly and annual pay, the take-home breakdown, a 40 hour comparison of the rates, and the full dated history.

{
  "type": "object",
  "title": "nz_minimum_wage_calculatorArguments",
  "properties": {
    "as_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "As At",
      "default": null
    },
    "tax_code": {
      "enum": [
        "M",
        "ME"
      ],
      "type": "string",
      "title": "Tax Code",
      "default": "M"
    },
    "wage_type": {
      "enum": [
        "adult",
        "starting_out",
        "training",
        "living_wage",
        "custom"
      ],
      "type": "string",
      "title": "Wage Type",
      "default": "adult"
    },
    "custom_rate": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Custom Rate",
      "default": null
    },
    "student_loan": {
      "type": "boolean",
      "title": "Student Loan",
      "default": false
    },
    "hours_per_week": {
      "type": "number",
      "title": "Hours Per Week",
      "default": 40
    },
    "kiwisaver_rate": {
      "type": "number",
      "title": "Kiwisaver Rate",
      "default": 0.035
    }
  }
}

Work out a week's gross pay in New Zealand with overtime at time and a half, double time and time and a quarter. Use for: 'overtime calculator NZ', 'how much is time and a half', 'double time pay', 'is overtime required by law NZ', 'penal rates NZ', 'weekly pay with overtime'. NEW ZEALAND LAW SETS NO OVERTIME RATE. There is no statutory time and a half for hours over 40, and no weekend or night rate. The multipliers here apply only if the employment agreement provides them. Overtime pay must be agreed in the agreement (Employment New Zealand): it may be factored into a salary, or paid at the normal rate or higher, so a salaried employee's extra hours may earn nothing extra. The one statutory premium is a public holiday worked: at least time and a half for the time worked, based on relevant daily pay or average daily pay (Holidays Act 2003 s50), and an alternative holiday only if the day would otherwise have been a working day (s56). That is nz_holiday_pay_calculator. PAY FOR EVERY HOUR, OVERTIME INCLUDED, MUST MEET THE MINIMUM WAGE (Minimum Wage Act 1983 s6). On a salary, divide pay by all hours worked to check. below_adult_minimum_wage flags an ordinary rate under the ADULT minimum, read from the rate register; that can be lawful on the starting-out or training rate, under 16, or under a minimum wage exemption permit (Minimum Wage Act 1983 s8), and the notes say which. THE PREMIUM IS NOT THE OVERTIME PAY. Five hours at time and a half on $30 is $225, but $150 of that is what the hours would earn anyway; the premium is $75. Args: hourly_rate: Ordinary gross hourly rate. normal_hours: Ordinary hours this week. time_and_half_hours: Hours at 1.5x. double_time_hours: Hours at 2x. time_and_quarter_hours: Hours at 1.25x, for example Saturday work under some agreements. Returns: Normal pay, each overtime band, total weekly pay, the overtime premium, a rate table and whether the ordinary rate is below the adult minimum.

{
  "type": "object",
  "title": "nz_overtime_pay_calculatorArguments",
  "required": [
    "hourly_rate"
  ],
  "properties": {
    "hourly_rate": {
      "type": "number",
      "title": "Hourly Rate"
    },
    "normal_hours": {
      "type": "number",
      "title": "Normal Hours",
      "default": 40
    },
    "double_time_hours": {
      "type": "number",
      "title": "Double Time Hours",
      "default": 0
    },
    "time_and_half_hours": {
      "type": "number",
      "title": "Time And Half Hours",
      "default": 0
    },
    "time_and_quarter_hours": {
      "type": "number",
      "title": "Time And Quarter Hours",
      "default": 0
    }
  }
}

Check the presence-day test for New Zealand citizenship by grant. Use for: 'how many days do I need in NZ for citizenship', 'NZ citizenship eligibility', '1350 days citizenship', '240 days rule NZ citizenship', 'can I apply for NZ citizenship yet', 'citizenship presence calculator'. BOTH TESTS MUST PASS, AND NEITHER RESCUES THE OTHER. Over the five years immediately before applying (Citizenship Act 1977 s8(2)(b)): at least 1,350 days in New Zealand in total, AND at least 240 days in each of the five years. A comfortable total of 1,410 still fails if one 12-month period was 230. Five bare minimums of 240 total only 1,200, which fails the total. Lead with whichever test failed and by how much. ONLY DAYS ENTITLED TO BE IN NZ INDEFINITELY COUNT: for example on a resident or permanent resident visa, as an Australian citizen, or as an NZ citizen by descent (DIA Guidance 1(a)). Time on a work, student or visitor visa does not count towards either test. DIA has confirmed in writing (reply to data.govt.nz dataset request 847, 18 September 2023) that the days you leave and arrive in New Zealand both count as days in New Zealand. A "YEAR" IS A 12-MONTH PERIOD COUNTED BACK FROM THE DATE DIA RECEIVES THE COMPLETED APPLICATION AND FEE, not a calendar year. All five periods move with that date, so a later date can pass where today fails, but it needs a fresh count of all five, not just a low period falling away. This is eligibility guidance only. Applications are decided by the Minister of Internal Affairs, or by the Department of Internal Affairs under delegated authority, who also assess DIA's six other requirements: entitlement to reside indefinitely, good character, knowledge of the responsibilities and privileges of citizenship, English language, intention to reside and full capacity (in other_requirements). Args: days_per_year: Five day counts, MOST RECENT FIRST (months 1 to 12 before applying, then 13 to 24, ... 49 to 60). Each a whole number, 0 to 366. Returns: Whether the presence requirement is met, the total against 1,350, each period against 240 with its margin, the number of periods below 240, the page's plain-language verdict and explanation, and DIA's seven requirements.

{
  "type": "object",
  "title": "nz_citizenship_calculatorArguments",
  "required": [
    "days_per_year"
  ],
  "properties": {
    "days_per_year": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "title": "Days Per Year"
    }
  }
}

Count the New Zealand standard drinks in a drink, with grams of pure alcohol and calories from the alcohol. Use for: 'how many standard drinks in a bottle of wine', 'standard drinks calculator nz', 'how many standard drinks in a beer', 'standard drinks in a can of rtd', 'what is a standard drink nz', 'standard drinks in a shot'. ONE NZ STANDARD DRINK IS 10 GRAMS OF PURE ALCOHOL: volume (mL) x ABV / 100 x 0.789 (the density of ethanol) / 10. A 330 mL can at 5% is 1.3 standard drinks, so a six-pack is nearly eight, and a 750 mL bottle of wine at 13% is 7.7. THE SIZE IS NATIONAL. A UK unit is 8 g and a US drink 14 g; this counts the New Zealand drink only. ABV IS A PERCENTAGE: 5 for 5%, 40 for 40%. Values between 0 and 0.5 are refused as likely fractions. THIS DOES NOT ESTIMATE BLOOD OR BREATH ALCOHOL and never says anyone is safe, sober or fit to drive. Do not use it to answer whether someone can drive. THE LIMITS DIFFER BY SEX. Health New Zealand Te Whatu Ora's low-risk drinking advice: women no more than 2 standard drinks a day, 10 a week and 4 at a time; men no more than 3 a day, 15 a week and 5 at a time; everyone at least 2 alcohol-free days each week. Lower-risk is not no risk. Do not drink if pregnant, planning to get pregnant or breastfeeding; under 18; on medication that interacts with alcohol or with a condition made worse by drinking; unwell, depressed, tired or cold; or about to operate machinery or a vehicle or do anything risky. Never give one set of limits for everyone. Calories are kilocalories: 29 kJ per gram of alcohol / 4.18 (Food Standards Code Schedule 11), about 6.94 per gram. Args: volume_ml: Volume of one drink in millilitres. abv_percent: Alcohol by volume as a percentage, 5 for 5%. quantity: How many of that drink, a whole number of at least 1. preset: beer_330, beer_440, beer_500, craft_330, wine_150, wine_250, wine_bottle, spirit_30, spirit_45, rtd_330 or cider_330. limits_for: "women" (default) or "men": whose limits to compare with. Returns: Standard drinks (as the page shows them, and to two places), grams of alcohol, alcohol calories, the limits applied, the share of the weekly and at-a-time limits, and whether the total is within the at-a-time and daily limits.

{
  "type": "object",
  "title": "nz_standard_drinks_calculatorArguments",
  "properties": {
    "preset": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Preset",
      "default": null
    },
    "quantity": {
      "type": "integer",
      "title": "Quantity",
      "default": 1
    },
    "volume_ml": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Volume Ml",
      "default": null
    },
    "limits_for": {
      "type": "string",
      "title": "Limits For",
      "default": "women"
    },
    "abv_percent": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Abv Percent",
      "default": null
    }
  }
}

Work out an NCEA result: credits, the co-requisite, the certificate, endorsements and UE, on NZQA's Assessment Rules 2026. Use for: 'have I passed NCEA level 2', 'how many credits do I need for NCEA', 'NCEA literacy and numeracy co-requisite', 'NCEA merit endorsement', 'how many credits for excellence endorsement', 'course endorsement NCEA', 'do I have University Entrance', 'NCEA calculator'. 60 CREDITS AT THE LEVEL OR ABOVE, PLUS THE CO-REQUISITE (10 LITERACY AND 10 NUMERACY, MET ONCE FOR EVERY LEVEL). NZQA's "80 credits" is 60 + 20. The old rule of 80 credits alone is gone: 80 credits with no co-requisite is not a certificate. Ask whether the co-requisite is met; if it was met in an earlier year, or under the old rules in 2023 or earlier, pass 10 and 10. Do not put co-requisite credits in subjects. 50 GAINS A CERTIFICATE ENDORSEMENT, AND 49 DOES NOT, BUT ONLY WITH THE CERTIFICATE. Excellence: 50 Excellence credits. Merit: 50 at Merit OR Excellence, so Excellence credits count towards Merit. With 50 credits but no certificate, *_endorsement_credits_met is true and *_endorsement_earned is false: say it is awarded once the level is. COURSE ENDORSEMENT IS 14 CREDITS IN ONE COURSE: Excellence at Excellence, Merit at Merit or above, Achieved at any grade. UE (LEVEL 3 ONLY): NCEA Level 3, three approved subjects each with 14+ credits, literacy of 5 reading AND 5 writing (not 10 in total), and 10 numeracy credits. Say which requirement is missing. Not checked: the level of each standard, and the 3 internal and 3 external credits a course endorsement needs in most courses. New qualifications replace NCEA from 2028 and are not modelled. For a rank score, use nz_ncea_rank_score_calculator. Args: level: 1, 2 or 3. subjects: List of {"name", "achieved", "merit", "excellence", "ue_approved"}; credits that count towards the 60, whole numbers; ue_approved is for Level 3 subjects on NZQA's approved list. ue_literacy_reading_credits: Level 3: Level 2+ reading credits on the UE list. ue_literacy_writing_credits: Level 3: Level 2+ writing credits on the UE list. ue_numeracy_credits: Level 3: UE numeracy credits. literacy_corequisite_credits: literacy co-requisite credits (need 10). numeracy_corequisite_credits: numeracy co-requisite credits (need 10). Returns: Totals by grade, whether the 60 and the co-requisite are met, whether the level is achieved and what is missing, both certificate endorsements with credits still needed, each course endorsement, and University Entrance at Level 3.

{
  "type": "object",
  "title": "nz_ncea_grade_calculatorArguments",
  "required": [
    "level",
    "subjects"
  ],
  "properties": {
    "level": {
      "type": "integer",
      "title": "Level"
    },
    "subjects": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "title": "Subjects"
    },
    "ue_numeracy_credits": {
      "type": "integer",
      "title": "Ue Numeracy Credits",
      "default": 0
    },
    "ue_literacy_reading_credits": {
      "type": "integer",
      "title": "Ue Literacy Reading Credits",
      "default": 0
    },
    "ue_literacy_writing_credits": {
      "type": "integer",
      "title": "Ue Literacy Writing Credits",
      "default": 0
    },
    "literacy_corequisite_credits": {
      "type": "integer",
      "title": "Literacy Corequisite Credits",
      "default": 0
    },
    "numeracy_corequisite_credits": {
      "type": "integer",
      "title": "Numeracy Corequisite Credits",
      "default": 0
    }
  }
}

List New Zealand public holidays for a year, count them, and find the next one. Use for: 'public holidays nz 2027', 'when is the next public holiday nz', 'how many public holidays in nz', 'is waitangi day mondayised', 'when is matariki 2028', 'auckland anniversary day', 'nz stat holidays'. THE COUNT IS NOT ALWAYS ELEVEN. Ten before Matariki began in 2022, twelve in 2022 with the one-off Queen Elizabeth II Memorial Day, eleven since, plus one for a region's anniversary day. MONDAYISATION MOVES THE DAY OFF, NOT THE HOLIDAY. For someone who does not work that weekend day, Christmas, Boxing Day, 1 and 2 January move from a Saturday to the Monday and from a Sunday to the TUESDAY (so a Sunday Christmas is Tuesday 27 and Boxing Day Monday 26). Waitangi Day and Anzac Day move to the Monday, and only from 2014. Each holiday carries both actual_date and date (the day off), with mondayised set when they differ. TWO HOLIDAYS CAN SHARE A DAY. Anzac Day fell on Easter Monday in 2011 and is Mondayised onto it in 2038. distinct_days_off counts the day once. MATARIKI is gazetted, not calculated, and is listed only from 2022. The gazetted dates run to 2052, which is the last year this covers. REGIONAL ANNIVERSARY DAYS are given on the day OBSERVED, which is rarely the anniversary: usually the Monday nearest it (Auckland 29 January was observed Monday 26 January 2026), but Taranaki is the second Monday in March, Southland Easter Tuesday, Canterbury Show Day Friday in November, South Canterbury the fourth Monday in September, Hawke's Bay the Friday before Labour Day and Marlborough the Monday after (Employment New Zealand). Each regional entry carries actual_date (the anniversary) and date (the day off). Available from 2010. Args: year: Calendar year, 2000 to 2052. Defaults to the year of after, or the current year. region: Optional anniversary region key, for example auckland, wellington, canterbury, otago. Omit for national holidays only. after: Optional ISO date. Returns the next holiday strictly after it. Returns: Every holiday with its actual and observed date, the national, regional and distinct day counts, and the next holiday when asked.

{
  "type": "object",
  "title": "nz_public_holidays_calculatorArguments",
  "properties": {
    "year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Year",
      "default": null
    },
    "after": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "After",
      "default": null
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null
    }
  }
}

Count New Zealand working days between two dates, or add or subtract N working days. Use for: 'working days between two dates nz', '10 working days from today nz', 'business days calculator nz', 'how many working days until christmas', '20 working days notice', 'subtract working days from a date'. THE END DATE IS COUNTED, THE START DATE IS NOT, unless include_start is true. Monday to Friday of one week is 4 business days by default. ADD AND SUBTRACT start from the next (or previous) day, so one business day after a Friday is the Monday. HOLIDAYS COME OUT ON THEIR OBSERVED DATES. A Saturday Anzac Day removes the Monday after it; Christmas and Boxing Day on a weekend remove the Monday and Tuesday. Waitangi Day and Anzac Day were only Mondayised from 2014, and Matariki exists only from 2022. A holiday on the weekend itself counts as a weekend day. A REGIONAL ANNIVERSARY DAY is excluded only when region is given, on the day it is OBSERVED that year, by Employment New Zealand's rules: usually the Monday nearest the anniversary (Auckland 29 Jan observed Monday 26 January 2026), with exceptions such as Southland on Easter Tuesday and Canterbury on Show Day Friday in November. Available from 2010. Statutes often define working days with their own extra exclusions, such as 25 December to 15 January. This does not apply those. Args: start_date: ISO date, YYYY-MM-DD. end_date: ISO date, for mode between. Counted. mode: between, add or subtract. days: Business days to add or subtract, at least 1. include_start: Whether the start date itself counts. Default False. region: Optional anniversary region key, for example auckland, wellington, canterbury. Returns: Business, calendar, weekend and holiday counts, the holidays met, the target date for add or subtract, and weeks and days.

{
  "type": "object",
  "title": "nz_business_days_calculatorArguments",
  "required": [
    "start_date"
  ],
  "properties": {
    "days": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Days",
      "default": null
    },
    "mode": {
      "type": "string",
      "title": "Mode",
      "default": "between"
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "End Date",
      "default": null
    },
    "start_date": {
      "type": "string",
      "title": "Start Date"
    },
    "include_start": {
      "type": "boolean",
      "title": "Include Start",
      "default": false
    }
  }
}

Work out New Zealand holiday pay: annual leave, 8% pay as you go, public holidays, or the leave payout on termination. Use for: 'how is holiday pay calculated NZ', 'holiday pay calculator', 'average weekly earnings vs ordinary weekly pay', '8% holiday pay casual', 'pay as you go holiday pay', 'do I get time and a half on a public holiday', 'alternative holiday day in lieu', 'holiday pay when I leave my job'. PICK THE MODE. Each has one rule that is regularly got wrong. annual_leave: leave is paid at the GREATER of ordinary weekly pay and average weekly earnings (1/52 of the gross earnings for the 12 months before the last pay period before the holiday). Someone whose overtime or commission lifts their average above their base is owed the average. pay_as_you_go: 8% of gross pay BEFORE the loading. $1,200 earns $96, so the pay is $1,296; 8% of $1,296 is the wrong base. Lawful only for a fixed term under twelve months or genuinely intermittent or irregular work, written into the agreement and an identifiable part of each pay. payg_allowed says whether it is; the loading is shown either way. Pass pay_periods_per_year (26 fortnightly, 12 monthly) for the annual figure. public_holiday: worked, at least time and a half for the hours, PLUS an alternative holiday (a paid day off later) if it was an otherwise working day. Time and a half is on everything they would have been paid for those hours; hourly_rate is taken as that. A day the employee would not otherwise have worked earns the time and a half only. Not worked on an otherwise working day: relevant daily pay (hourly_rate x normal_hours), or average daily pay (daily_pay_method="average" with days_worked_last_52_weeks) where relevant daily pay cannot practicably be worked out or varies. Alternative holidays do not expire; after 12 months the employee may ask to exchange one for payment. termination: ask whether they worked there 12 months. Over 12 months, the untaken ENTITLEMENT from completed years (untaken_weeks: not a payslip balance that includes leave accruing since the anniversary) at the greater of the two weekly rates, plus 8% of gross earnings since the last anniversary, less holiday_pay_already_paid; those earnings INCLUDE the leave paid out and any public holidays (public_holidays_in_leave_period, s40) and alternative holidays (alternative_holidays_owed) paid out, and earnings_since_anniversary should include final wages, notice pay and any bonus or commission. Under 12 months, service="under12": 8% of the earnings since they started. Same code as nz_final_pay_calculator, so the two agree. This is the Holidays Act 2003, which applies until the Employment Leave Act 2026 commences on 6 August 2028 (State school board staff on the education payroll: by Order in Council, no later than 6 August 2036). All figures are gross. Rules from the Act and Employment New Zealand. Args: mode: annual_leave, pay_as_you_go, public_holiday or termination. ordinary_weekly_pay: What a normal week earns. gross_earnings_last_52_weeks: 12 months of gross earnings, for AWE and average daily pay. leave_weeks: Weeks of leave taken (annual_leave). gross_pay_period: Gross pay before the 8% loading (pay_as_you_go). employment_type: casual-genuine, casual-doubtful, fixed-term-under, fixed-term-over or permanent (pay_as_you_go). in_agreement: 8% PAYG is in the written agreement. payslip_identified: The 8% is an identifiable part of the pay. pay_periods_per_year: Pay periods a year for the annual figure. worked: The public holiday was worked. otherwise_working_day: The day would otherwise have been worked. hours_worked: Hours worked on the public holiday. hourly_rate: Ordinary hourly rate. normal_hours: Hours they would have worked that day. multiplier: Public holiday rate, at least 1.5. public_holiday_days: Public holidays not worked. daily_pay_method: auto, relevant or average. days_worked_last_52_weeks: Days worked or on paid leave, for average daily pay. service: over12 or under12 (termination). untaken_weeks: Untaken entitlement from completed years, in weeks (termination). earnings_since_anniversary: Earnings since the last anniversary, including final wages (termination). public_holidays_in_leave_period: s40 public holidays (termination). alternative_holidays_owed: Alternative holidays not taken (termination). holiday_pay_already_paid: Holiday pay already paid in advance or as pay as you go (termination). Returns: total_gross for the mode, the working spelled out, the OWP and AWE comparison where it applies, PAYG eligibility, the daily rate and its basis, the alternative holiday, and the termination split.

{
  "type": "object",
  "title": "nz_holiday_pay_calculatorArguments",
  "properties": {
    "mode": {
      "type": "string",
      "title": "Mode",
      "default": "annual_leave"
    },
    "worked": {
      "type": "boolean",
      "title": "Worked",
      "default": true
    },
    "service": {
      "type": "string",
      "title": "Service",
      "default": "over12"
    },
    "multiplier": {
      "type": "number",
      "title": "Multiplier",
      "default": 1.5
    },
    "hourly_rate": {
      "type": "number",
      "title": "Hourly Rate",
      "default": 0
    },
    "leave_weeks": {
      "type": "number",
      "title": "Leave Weeks",
      "default": 0
    },
    "hours_worked": {
      "type": "number",
      "title": "Hours Worked",
      "default": 0
    },
    "in_agreement": {
      "type": "boolean",
      "title": "In Agreement",
      "default": true
    },
    "normal_hours": {
      "type": "number",
      "title": "Normal Hours",
      "default": 0
    },
    "untaken_weeks": {
      "type": "number",
      "title": "Untaken Weeks",
      "default": 0
    },
    "employment_type": {
      "type": "string",
      "title": "Employment Type",
      "default": "casual-genuine"
    },
    "daily_pay_method": {
      "type": "string",
      "title": "Daily Pay Method",
      "default": "auto"
    },
    "gross_pay_period": {
      "type": "number",
      "title": "Gross Pay Period",
      "default": 0
    },
    "payslip_identified": {
      "type": "boolean",
      "title": "Payslip Identified",
      "default": true
    },
    "ordinary_weekly_pay": {
      "type": "number",
      "title": "Ordinary Weekly Pay",
      "default": 0
    },
    "public_holiday_days": {
      "type": "number",
      "title": "Public Holiday Days",
      "default": 1
    },
    "pay_periods_per_year": {
      "type": "integer",
      "title": "Pay Periods Per Year",
      "default": 52
    },
    "otherwise_working_day": {
      "type": "boolean",
      "title": "Otherwise Working Day",
      "default": true
    },
    "holiday_pay_already_paid": {
      "type": "number",
      "title": "Holiday Pay Already Paid",
      "default": 0
    },
    "alternative_holidays_owed": {
      "type": "number",
      "title": "Alternative Holidays Owed",
      "default": 0
    },
    "days_worked_last_52_weeks": {
      "type": "number",
      "title": "Days Worked Last 52 Weeks",
      "default": 0
    },
    "earnings_since_anniversary": {
      "type": "number",
      "title": "Earnings Since Anniversary",
      "default": 0
    },
    "gross_earnings_last_52_weeks": {
      "type": "number",
      "title": "Gross Earnings Last 52 Weeks",
      "default": 0
    },
    "public_holidays_in_leave_period": {
      "type": "number",
      "title": "Public Holidays In Leave Period",
      "default": 0
    }
  }
}

Estimate a New Zealand house's 2026/27 council rates and water charges. Use for: 'how much are rates on a $700k house', 'council rates calculator nz', 'auckland rates estimate', 'christchurch rates and water', 'what are water rates in wellington', 'rates per week nz'. ONLY NINE COUNCILS, each for a standard house in the area stated: Auckland (Watercare-metered house), Wellington City, Christchurch City, Hamilton City, Tauranga City, Dunedin City, Selwyn (Rolleston), Waimakariri (Rangiora) and Queenstown Lakes (Queenstown). Any other council or town (Kaiapoi, Wanaka, Upper Hutt, Nelson...) returns an error: tell the user to use that council's own rates search. Never substitute another council's figures. FIGURES ARE EACH COUNCIL'S ADOPTED 2026/27 RATES, GST inclusive, with the water organisation's 2026/27 prices where it bills water (Watercare, Tiaki Wai, IAWAI, Selwyn Water). Usage matters only in Auckland, Tauranga, Selwyn, and Christchurch above 900 litres a day (each part of a m3 charged as a whole one). A usage of 0 is 0; null is the 170 m3 starting figure. For Waimakariri pass land_value, or its urban drainage rate is left out (land_value_rate_left_out says so). Outside Auckland (a unitary council) regional council rates are NOT included. Every answer carries source_url, rating_year and not_included. Args: capital_value: The property's capital value in dollars. council: A council key or name from the page. water_usage_m3: Annual water use in cubic metres. Default 170. land_value: The property's land value; used only for Waimakariri. Returns: General rate, UAGC, water, wastewater, stormwater, rubbish, other targeted rates, the total yearly, quarterly, monthly and weekly, rates as a share of CV, who bills water, the 2026/27 rebate figures, the rating year and the council's source.

{
  "type": "object",
  "title": "nz_rates_water_calculatorArguments",
  "required": [
    "capital_value"
  ],
  "properties": {
    "council": {
      "type": "string",
      "title": "Council",
      "default": "christchurch"
    },
    "land_value": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Land Value",
      "default": null
    },
    "capital_value": {
      "type": "number",
      "title": "Capital Value"
    },
    "water_usage_m3": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Water Usage M3",
      "default": 170
    }
  }
}

Estimate customs duty, GST and the Customs and MPI goods levy on goods sent or shipped to New Zealand. Use for: 'import duty calculator nz', 'how much gst on imports nz', 'customs charges on a shipment', 'landed cost nz', 'do I pay duty on goods from overseas', 'customs goods levy', 'is there duty under $1000'. $1,000 OR LESS, CUSTOMS COLLECTS NOTHING (NZ Customs Service): no duty, GST or levy unless the item or shipment is valued over NZ$1,000. The international freight to New Zealand is NOT part of that value. An overseas supplier may already have charged GST at checkout. Same-supplier orders arriving the same day count as one shipment. Alcohol and tobacco are charged whatever their value and are not covered by this tool. NOT FOR LUGGAGE: goods in a traveller's baggage fall under the $700 traveller allowance and carry neither goods levy. Say so if asked. Over $1,000: duty is on the goods value only, not the freight. GST is charged on the goods, the freight and insurance, AND the duty. $1,500 of goods with $150 freight at 5% duty is $75 duty and $258.75 GST. The goods levy (from 1 April 2026, excluding GST) is $51.81 by air or post ($7.24 Customs + $44.57 MPI) and $118.44 by sea ($73.87 + $44.57); GST is added. By air the example pays $393.33 to Customs. A broker will also charge for their services. GIFTS are charged like other goods here; Customs sources disagree on a gift over $1,000 (see not_modelled), so tell the user to confirm. Values are in NZD; there is no currency conversion. Args: goods_value: Customs value of the goods in NZD, excluding freight. freight_insurance: International freight and insurance in NZD. duty_rate_percent: Duty rate as a percentage, e.g. 5. transport: 'air', 'post' (air rate) or 'sea'. Default 'air'. levy_excl_gst: Override the goods levy, NZD excl GST. Omit for the register. Returns: Whether Customs collects, duty, the GST base, GST, the levy with its GST, the total payable to Customs, the landed cost, the sources and what is not modelled.

{
  "type": "object",
  "title": "nz_import_duty_calculatorArguments",
  "required": [
    "goods_value"
  ],
  "properties": {
    "transport": {
      "type": "string",
      "title": "Transport",
      "default": "air"
    },
    "goods_value": {
      "type": "number",
      "title": "Goods Value"
    },
    "levy_excl_gst": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Levy Excl Gst",
      "default": null
    },
    "duty_rate_percent": {
      "type": "number",
      "title": "Duty Rate Percent",
      "default": 0
    },
    "freight_insurance": {
      "type": "number",
      "title": "Freight Insurance",
      "default": 0
    }
  }
}