---
title: "What is owed on redundancy in New Zealand, mandatory and contractual"
method: POST
path: "/v1/redundancy-entitlement"
tags: ["Calculators"]
---

# What is owed on redundancy in New Zealand, mandatory and contractual

`POST /v1/redundancy-entitlement`

## Request

- Base URL: `https://api.calculate.co.nz`
- URL: `https://api.calculate.co.nz/v1/redundancy-entitlement`
- Auth: API key in header `X-API-Key`

Gross entitlements when a role is disestablished.

Start here: NEW ZEALAND HAS NO STATUTORY REDUNDANCY PAY. An employee gets
redundancy compensation only if their employment agreement provides for it.
This is the opposite of the UK and Australian position and it is the most
common error in general advice about NZ redundancy. The default clause is
"none" and `statutory_position` says this in words; pass it on.

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 /v1/lump-sum-tax for the tax on it.

## Request body

- RedundancyEntitlementRequest
  - `annual_salary` number, required: Gross annual salary.
  - `years_of_service` integer: Completed years. Part years are not counted.
  - `notice_weeks` integer: Notice period in weeks.
  - `notice_worked` boolean: True if the notice period is worked, false if paid in lieu. It changes where the money appears, not how much there is.
  - `annual_leave_days` number: Days of annual leave accrued and not taken.
  - `alternative_holiday_days` number: Alternative holidays ('days in lieu') not taken.
  - `redundancy_clause` 'none' | '2_weeks' | '3_weeks' | '4_weeks' | 'fixed_4' | 'fixed_8' | 'fixed_13' | 'custom': What the employment agreement provides. Default is none, because New Zealand has no statutory redundancy pay.
  - `custom_redundancy_amount` number: Used only when redundancy_clause is 'custom'.
  - `outstanding_wages` number: Wages worked and not yet paid.

## Response `200`

Final pay, everything received all in, and the two kept apart.

- RedundancyEntitlementResponse
  - `result` RedundancyEntitlementResult, required
    - `annual_salary` number, required: Salary as given.
    - `weekly_pay` number, required: Salary divided by 52.
    - `daily_pay` number, required: Salary divided by 260 working days.
    - `years_of_service` integer, required: Completed years as given.
    - `outstanding_wages` number, required: Unpaid wages as given.
    - `annual_leave_days` number, required: Annual leave days as given.
    - `annual_leave_payout` number, required: Annual leave days at the daily rate.
    - `alternative_holiday_days` number, required: Alternative holidays as given.
    - `alternative_holiday_payout` number, required: Alternative holidays at the daily rate.
    - `notice_weeks` integer, required: Notice period as given.
    - `notice_worked` boolean, required: Whether notice is worked.
    - `notice_wages` number, required: Pay for the notice period. Received either way.
    - `notice_payout` number, required: The part of the notice that lands in the final pay. Nil when the notice is worked, because it arrives as ordinary salary instead.
    - `total_mandatory` number, required: What is owed by law: wages, leave, alternative holidays, notice in lieu.
    - `redundancy_clause` string, required: Clause as given.
    - `redundancy_clause_label` string, required: The clause in words.
    - `redundancy_compensation` number, required: Contractual redundancy pay. Zero unless a clause provides for it.
    - `total_package` number, required: The final pay: mandatory plus compensation.
    - `total_all_in` number, required: Everything received, wherever it is paid from. The same figure whether notice is worked or paid in lieu. Quote this one when somebody asks what they will get.
    - `statutory_position` string, required: The New Zealand position on redundancy pay, in words.
    - `notes` string[], required: What applied to this case.
    - `excludes` string[], required: What this deliberately does not do.
  - `disclaimer` string, required: Scope and limits of this calculation.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/calculate/apis/calculate-co-nz-api.md) · [All operations](https://skmtc.dev/calculate/apis/calculate-co-nz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calculate/apis/calculate-co-nz-api/revisions/aa59a8e76614?raw)