---
title: "ACC weekly compensation, with the floor and the ceiling both shown"
method: POST
path: "/v1/acc-weekly-compensation"
tags: ["Calculators"]
---

# ACC weekly compensation, with the floor and the ceiling both shown

`POST /v1/acc-weekly-compensation`

## Request

- Base URL: `https://api.calculate.co.nz`
- URL: `https://api.calculate.co.nz/v1/acc-weekly-compensation`
- Auth: API key in header `X-API-Key`

Estimate what ACC pays while an injury stops someone working.

"80% of your earnings" is the headline and it is incomplete three ways.

  - The FIRST WEEK is the employer's cost, not ACC's. ACC starts from the
    second week. People routinely budget as though payments start on day
    one, and `first_week_paid_by` says who actually pays it.
  - There is a CEILING. Compensation cannot exceed 80% of the maximum
    liable earnings, the same ceiling the earner levy stops at. A high
    earner is capped well below 80% of what they were making.
  - There is a FLOOR, but only for full-time earners, meaning 30 hours a
    week or more. It is 80% of the adult minimum wage for a 40 hour week.
    A part-timer on low earnings is NOT lifted to it, which is the part
    most often assumed the other way round.

Both bounds are derived from the rate register rather than typed, so they
move on 1 April with the levy ceiling and the minimum wage. `minimum_applied`
and `maximum_applied` say whether either actually bound this answer, and
`ceiling_source` and `floor_source` carry the provenance.

The short-term basis uses the four weeks before the injury and applies for
the first four weeks. After that ACC moves to a 52 week basis, which
matters a great deal for anyone with irregular earnings.

## Request body

- AccWeeklyCompensationRequest
  - `weekly_earnings` number, required: Gross weekly earnings before the injury.
  - `hours_per_week` number: Hours normally worked. 30 or more qualifies for the full-time minimum.
  - `basis` 'short_term' | 'long_term': 'short_term' for the first four weeks, on the four weeks before the injury. 'long_term' after that, on 52 weeks.

## Response `200`

What ACC pays each week, and which bound applied.

- AccWeeklyCompensationResponse
  - `result` AccWeeklyCompensationResult, required
    - `weekly_earnings_used` number, required: Earnings the calculation used.
    - `compensation_rate` number, required: ACC pays this share of earnings.
    - `uncapped_weekly` number, required: 80% of earnings, before any floor or ceiling.
    - `minimum_applied` boolean, required: Whether the full-time minimum lifted the figure.
    - `maximum_applied` boolean, required: Whether the ceiling reduced it.
    - `weekly_compensation` number, required: What ACC pays each week.
    - `first_week_paid_by` string, required: The first week is the employer's cost, not ACC's.
    - `first_week_amount` number, required: What the employer pays for that first week.
    - `maximum_weekly` number, required: Ceiling: 80% of maximum liable earnings a week.
    - `minimum_weekly` number, required: Floor for a full-time earner: 80% of the adult minimum wage for 40 hours. Zero if not full time.
    - `basis` string, required: Which earnings period applied.
    - `ceiling_source` object, required: The register figure the ceiling derives from.
    - `floor_source` object, required: The register figure the floor derives from.
    - `inputs` object, required: The inputs used, with defaults filled in.
  - `disclaimer` string, required: Scope and limits of this estimate.

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