---
title: "One rate by id"
method: GET
path: "/v1/rates/{rate_id}"
tags: ["Reference data"]
---

# One rate by id

`GET /v1/rates/{rate_id}`

## Request

- Base URL: `https://api.calculate.co.nz`
- URL: `https://api.calculate.co.nz/v1/rates/{rate_id}`
- Auth: API key in header `X-API-Key`

A single rate by its stable id, for example `acc-earner-levy`.

Ids do not change when a value does, so they are safe to store and to key
on. Call `GET /v1/rates` to see them all.

## Path parameters

- `rate_id` string, required

## Response `200`

The rate, its effective date, source and review cycle.

- RateRecord
  - `id` string, required: Stable identifier. Safe to store and to key on.
  - `label` string, required: What the figure is, in words.
  - `value` string, required: The current value, as published. A string so 1.75 and 0.0175 are never confused by a float.
  - `effective_from` string, nullable: ISO date the value took effect, where the source states one.
  - `source` string, nullable: Where it was read from. A URL for anything verified against an issuing body.
  - `verified_on` string, nullable: ISO date this figure was last checked against the issuing body. NULL means recorded but not yet verified, and is deliberately visible rather than hidden.
  - `review_cycle` string, required: When it next changes: annual-1-april, budget-may, periodic, or on-legislative-change. This is the field to filter on if you want to know what to re-check and when.
  - `previous_values` string[], nullable: Prior values, most recent first. Undated for now.
  - `history_note` string, nullable: The limits of previous_values.
  - `note` string, nullable: Anything a consumer needs to know about this figure.

## 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)