---
title: "What an hourly rate is worth as a salary"
method: POST
path: "/v1/hourly-to-salary"
tags: ["Calculators"]
---

# What an hourly rate is worth as a salary

`POST /v1/hourly-to-salary`

## Request

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

Convert an hourly rate into a salary, before and after tax.

Gives gross weekly, fortnightly, monthly and annual, then PAYE, the ACC
earner levy, KiwiSaver and any student loan, then what is actually left.

`kiwisaver_rate` is a DECIMAL. 0.03 means 3%. Sending 3 would try to
contribute three times the salary and is rejected.

Two figures look similar and answer different questions. `net_weekly`
divides by 52 always, so it is what lands each week across a whole year.
`effective_hourly_after_tax` divides by the hours actually worked, so for a
40 week year it is higher. That second one is the number to compare a wage
job against a salaried one.

Salary and wages only, on a primary tax code.

## Request body

- HourlyToSalaryRequest
  - `hourly_rate` number, required: Gross pay per hour in NZD.
  - `hours_per_week` number: Ordinary hours a week. 40 is full time.
  - `weeks_per_year` number: Weeks actually paid. Fewer for seasonal, academic or fixed-term work.
  - `kiwisaver_rate` number: Employee contribution as a DECIMAL: 0.03 for 3%, not 3.
  - `has_student_loan` boolean: Whether repayments are deducted.

## Response `200`

Gross at each frequency, deductions, and take-home pay.

- HourlyToSalaryResponse
  - `result` HourlyToSalaryResult, required
    - `hourly_rate` number, required: Rate you sent.
    - `hours_per_week` number, required: Hours a week you sent.
    - `weeks_per_year` number, required: Weeks a year you sent.
    - `gross_weekly` number, required: Gross pay for one week.
    - `gross_fortnightly` number, required: Two weeks of gross pay.
    - `gross_monthly` number, required: A twelfth of the annual gross.
    - `gross_annual` number, required: Weekly gross times weeks worked.
    - `paye` number, required: Income tax for the year, after any IETC.
    - `acc_levy` number, required: ACC earner levy, 1.75% up to the cap.
    - `kiwisaver` number, required: Your KiwiSaver contribution.
    - `student_loan` number, required: Repayments at 12% above the threshold.
    - `total_deductions` number, required: Everything taken off the gross.
    - `net_annual` number, required: Take-home pay for the year.
    - `net_weekly` number, required: Net annual divided by 52, ALWAYS 52 even for a shorter working year, so it is what lands each week across the whole year.
    - `effective_hourly_after_tax` number, required: Net pay divided by hours ACTUALLY worked, so this uses weeks_per_year rather than 52. What an hour was really worth, and the figure to compare a wage job against a salaried one.
  - `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)