# Calculate.co.nz Calculators API

**Canonical:** https://apis.io/apis/calculate-co-nz/calculate-co-nz-calculators-api/  
**Provider:** Calculate.co.nz — https://apis.io/providers/calculate-co-nz/  
**Base URL:** https://api.calculate.co.nz  
**Documentation:** https://www.calculate.co.nz/reference/

Calculate.co.nz Calculators API is one of 4 APIs that [Calculate.co.nz](https://apis.io/providers/calculate-co-nz/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Calculators. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

New Zealand tax, money and health calculations. Each one is a port of the calculator of the same name on calculate.co.nz, and the website is the reference: where the two disagree the API is wrong until proven otherwise, and the test suite fails the build.

## Operations (46)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/paye` | NZ take-home pay after PAYE |
| POST | `/v1/gst` | Add or remove NZ GST |
| POST | `/v1/bmi` | Body mass index and healthy weight range |
| POST | `/v1/mortgage` | Mortgage repayments and lifetime totals |
| POST | `/v1/annual-leave` | Annual leave balance projected forward |
| POST | `/v1/fuel-cost` | Fuel cost of a trip and of regular driving |
| POST | `/v1/tax-refund` | NZ income tax refund or bill for a year |
| POST | `/v1/gpa` | Grade point average on the NZ nine point scale |
| POST | `/v1/hourly-to-salary` | What an hourly rate is worth as a salary |
| POST | `/v1/work-hours` | Total hours from a timesheet, and what they pay |
| POST | `/v1/bonus-tax` | Tax on a bonus or commission payment |
| POST | `/v1/power-tower` | Power tower (tetration), a^^n |
| POST | `/v1/parental-leave` | NZ paid parental leave payment and shortfall |
| POST | `/v1/net-to-gross` | The gross salary needed to take home a given amount |
| POST | `/v1/final-pay` | What is owed on leaving a job, gross |
| POST | `/v1/secondary-tax` | Secondary tax code for a second income, and the year-end position |
| POST | `/v1/pro-rata-salary` | A full-time salary scaled to part-time hours |
| POST | `/v1/lump-sum-tax` | PAYE on a redundancy or lump sum, by IRD's rate table |
| POST | `/v1/working-for-families` | Working for Families entitlement after abatement |
| POST | `/v1/road-user-charges` | Road user charges for an EV, diesel or plug-in hybrid |
| POST | `/v1/electricity-cost` | Household electricity cost by region and appliance |
| POST | `/v1/ncea-rank-score` | University rank score (Auckland, Massey, Otago method) from NCEA, and an… |
| POST | `/v1/vehicle-loan` | Vehicle loan repayments and what the interest costs |
| POST | `/v1/energy-expenditure` | BMR, TDEE, a calorie target and the macros to hit it |
| POST | `/v1/kiwisaver` | KiwiSaver balance projected to retirement |
| POST | `/v1/fbt` | Fringe benefit tax on a vehicle, a low-interest loan or another benefit |
| POST | `/v1/redundancy-entitlement` | What is owed on redundancy in New Zealand, mandatory and contractual |
| POST | `/v1/grocery-budget` | A weekly grocery budget for a named New Zealand household |
| POST | `/v1/contractor-vs-employee` | Contracting against salaried employment, on what you actually keep |
| POST | `/v1/benefit-entitlement` | Weekly main benefit, abatement and Accommodation Supplement |
| POST | `/v1/schedular-payments` | Withholding tax on a schedular payment to a contractor |
| POST | `/v1/acc-weekly-compensation` | ACC weekly compensation, with the floor and the ceiling both shown |
| POST | `/v1/sick-leave` | Sick leave entitlement and balance under the Holidays Act |
| POST | `/v1/tax-code` | The right New Zealand tax code, and why |
| POST | `/v1/paye-due-dates` | When an employer must pay PAYE and file the pay run |
| POST | `/v1/depreciation` | Straight line or diminishing value depreciation, year by year |
| POST | `/v1/minimum-wage` | NZ minimum wage on a date, and take-home pay |
| POST | `/v1/overtime-pay` | Weekly pay with time and a half, double time and time and a quarter |
| POST | `/v1/citizenship-presence` | NZ citizenship by grant: the 1,350 and 240 day presence test |
| POST | `/v1/standard-drinks` | How many NZ standard drinks are in a drink |
| POST | `/v1/ncea-grade` | NCEA result: credits, co-requisite, certificate, endorsements and University… |
| POST | `/v1/public-holidays` | New Zealand public holidays for a year, and the next one |
| POST | `/v1/business-days` | New Zealand working days between dates, or N working days from a date |
| POST | `/v1/holiday-pay` | Holiday pay under the Holidays Act: leave, 8% PAYG, public holidays, termination |
| POST | `/v1/rates-water` | 2026/27 council rates and water charges for one house |
| POST | `/v1/import-duty` | Customs duty, GST and the goods levy on goods sent or shipped to New Zealand |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/calculate-co-nz/openapi/calculate-co-nz-calculators-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/calculate-co-nz/json-schema/calculate-co-nz-holiday-pay-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/calculate-co-nz/json-schema/calculate-co-nz-minimum-wage-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/calculate-co-nz/json-schema/calculate-co-nz-final-pay-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/calculate-co-nz/json-schema/calculate-co-nz-import-duty-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/calculate-co-nz/json-schema/calculate-co-nz-ncea-rank-score-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/calculate-co-nz/json-schema/calculate-co-nz-electricity-cost-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/calculate-co-nz/apis.yml

## Other Calculate.co.nz APIs (3)

- [Calculate.co.nz Discovery API](https://apis.io/apis/calculate-co-nz/calculate-co-nz-discovery-api/)
- [Calculate.co.nz Reference data API](https://apis.io/apis/calculate-co-nz/calculate-co-nz-reference-data-api/)
- [Calculate.co.nz Service API](https://apis.io/apis/calculate-co-nz/calculate-co-nz-service-api/)

## Tags

Calculators

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/calculate-co-nz/calculate-co-nz-calculators-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/calculate-co-nz/.