The gross salary needed to take home a given amount
Work backwards from a take-home figure to the salary that produces it.
This is the question behind "I need $1,200 a week in the hand, what do I ask for", and it cannot be answered by scaling: tax is progressive and the ACC levy is capped, so the gap between gross and net widens as income rises. Doubling the target does not double the gross.
deductions_included is the field to read first. Take-home means different things to different people, and the same target produces a different gross depending on whether KiwiSaver and a student loan sit inside it. By default only income tax and the ACC levy do, which is what the website page assumes.
The Independent Earner Tax Credit is not applied. It would lower the gross needed, and eligibility turns on facts this endpoint does not ask for.
Request
- Base URL: https://api.calculate.co.nz
- URL: https://api.calculate.co.nz/v1/net-to-gross
- Auth: API key in header X-API-Key
Request body
Example request
{
"has_student_loan": false,
"kiwisaver_rate": 0,
"period": "weekly",
"target_net": 1200
}Response
The gross salary, and every deduction between it and the target.
Example response
{
"disclaimer": "Estimate only. The target is treated as after income tax and the ACC earner levy, plus any KiwiSaver or student loan you asked for, and nothing else. No tax credits are applied. Not tax advice.",
"result": {
"acc_levy": 1402.08,
"deductions_included": [
"income tax",
"ACC earner levy"
],
"effective_deduction_rate": 22.12,
"gross_annual": 80118.77,
"gross_per_period": 1540.75,
"income_tax": 16316.69,
"kiwisaver_employee": 0,
"net_annual": 62400,
"net_per_period": 1200,
"period": "weekly",
"student_loan": 0,
"target_net_annual": 62400,
"tax_year": "2026/27"
}
}Changes
No recorded changes to this operation across all 1 revision of this API.