# Calculate.co.nz Reference data API

**Canonical:** https://apis.io/apis/calculate-co-nz/calculate-co-nz-reference-data-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 Reference data 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 Reference Data. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Current, dated, sourced New Zealand statutory rates: tax brackets, ACC, student loan, KiwiSaver, benefits. Maintained on a review calendar tied to when each figure actually changes, and consumed by the calculators above, so a wrong rate breaks a page rather than sitting unnoticed in a feed.

## Operations (2)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/rates` | Current New Zealand statutory rates, dated and sourced |
| GET | `/v1/rates/{rate_id}` | One rate by id |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/calculate-co-nz/openapi/calculate-co-nz-reference-data-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

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

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

## Tags

Reference Data

---

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