---
title: "What is owed on leaving a job, gross"
method: POST
path: "/v1/final-pay"
tags: ["Calculators"]
---

# What is owed on leaving a job, gross

`POST /v1/final-pay`

## Request

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

Final pay under the Holidays Act 2003: leave, notice and redundancy.

The twelve month line decides the whole calculation. Under twelve months of
service no leave entitlement has vested, so the Act pays 8% of everything
earned during the employment. At twelve months and over, unused leave is
paid out at a daily rate. Someone eleven months in with a leave balance
showing in payroll is owed the 8%, not the balance, and getting that branch
wrong is the usual mistake.

`service` is therefore the input that matters most, and `under12` requires
`gross_earnings_total` rather than a leave balance.

Read `excludes` before quoting the total. **Ordinary wages for days actually
worked are not in it** and are paid on top at the usual rate. Everything
returned is gross: the leave payout is taxed as an extra pay, which is what
`/v1/lump-sum-tax` is for.

New Zealand has no statutory redundancy compensation. Whatever the
employment agreement provides is an input here, never a derivation.

## Request body

- FinalPayRequest
  - `annual_salary` number: Annual salary. Give this OR hourly_rate.
  - `hourly_rate` number: Hourly rate, used with hours_per_week when there is no salary.
  - `hours_per_week` number: Ordinary hours a week. Only used with hourly_rate.
  - `service` string: over12 for twelve months service or more, under12 for less. This picks the calculation entirely: under twelve months the payout is 8% of gross earnings, not a leave balance.
  - `leave_balance_days` number: Unused annual leave in DAYS. Used when service is over12.
  - `gross_earnings_total` number: Total gross earned across the whole employment. Required when service is under12, where the payout is 8% of it.
  - `average_weekly_earnings` number: Optional 12 month average weekly earnings. The Holidays Act pays leave at the greater of this and ordinary weekly pay; supply it and the higher of the two is used.
  - `notice_weeks` number: Weeks of notice paid in lieu.
  - `redundancy` number: Agreed redundancy compensation from the employment agreement. New Zealand has no statutory minimum, so this is an input.

## Response `200`

Leave payout, notice pay and redundancy, with the leave working shown.

- FinalPayResponse
  - `result` FinalPayResult, required
    - `weekly_gross` number, required: Ordinary weekly pay.
    - `annual_gross` number, required: Annualised pay.
    - `service` string, required: Which branch was used, over12 or under12.
    - `leave_payout` number, required: Annual leave paid out, gross.
    - `leave_basis` string, required: What the leave payout was calculated on.
    - `leave_working` string, required: The leave calculation written out.
    - `notice_weeks` number, required: Weeks of notice paid.
    - `notice_pay` number, required: Notice pay, gross.
    - `redundancy` number, required: Redundancy compensation as given.
    - `total_final_pay` number, required: Sum of the three, gross.
    - `excludes` string[], required: What this total does NOT include. Ordinary wages for days worked are the big one: they are paid on top.
    - `tax_year` string, required: Tax year the figures relate to.
  - `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)