---
title: "List remittance totals"
method: GET
path: "/payrolls/{payroll}/remittances"
tags: ["Remittance Totals"]
---

# List remittance totals

`GET /payrolls/{payroll}/remittances`

Totals every statutory withholding, deduction and benefit on the payroll that names a remittance destination, and returns one figure per destination — what the payroll owes the CRA, Revenue Québec, each benefit provider, union, workers' compensation board and employer health tax authority.

Totals are computed when you ask for them, so they are available on a draft payroll that has never been approved, and on historical, correction and off-cycle payrolls that never produce payments at all. The whole list comes back in one response — there are no pages.

Line items that name no remittance destination are left out entirely; there is no catch-all entry for them. A payroll with nothing to remit returns an empty list.

## Path parameters

- `payroll` string, required

## Query parameters

- `account_provider` union
  - 'ca_ab_workers_compensation' | 'ca_bc_eht' | 'ca_bc_workers_compensation' | 'ca_cra' | 'ca_mb_eht' | 'ca_mb_workers_compensation' | 'ca_nb_workers_compensation' | 'ca_nl_eht' | 'ca_nl_workers_compensation' | 'ca_ns_workers_compensation' | 'ca_nt_government' | 'ca_nt_workers_compensation' | 'ca_nu_government' | 'ca_nu_workers_compensation' | 'ca_on_eht' | 'ca_on_workers_compensation' | 'ca_pe_workers_compensation' | 'ca_rq' | 'ca_sk_workers_compensation' | 'ca_yt_workers_compensation'
  - string[]
- `remittance_account_id` string
- `expand` string[]

## Response `200`

OK

- object
  - `object` string — The type of the object in Nmbr (`"list"`).
  - `data` object[]
    - `id` string — The unique identifier of the object in Nmbr.
    - `object` string — The type of the object in Nmbr (`"remittance_total"`).
    - `data` RemittanceTotal
      - `remittance_account` object — The remittance account the money is owed to. Expand it for the account identifier, address, and remitter type.
        - `id` string — The unique identifier of the object in Nmbr.
        - `object` string — The type of the object in Nmbr (`"remittance_account"`).
      - `account_provider` 'ca_ab_workers_compensation' | 'ca_bc_eht' | 'ca_bc_workers_compensation' | 'ca_cra' | 'ca_mb_eht' | 'ca_mb_workers_compensation' | 'ca_nb_workers_compensation' | 'ca_nl_eht' | 'ca_nl_workers_compensation' | 'ca_ns_workers_compensation' | 'ca_nt_government' | 'ca_nt_workers_compensation' | 'ca_nu_government' | 'ca_nu_workers_compensation' | 'ca_on_eht' | 'ca_on_workers_compensation' | 'ca_pe_workers_compensation' | 'ca_rq' | 'ca_sk_workers_compensation' | 'ca_yt_workers_compensation', nullable — The authority this account remits to. `null` for accounts that are not a tax authority, such as a benefit provider or union.
      - `label_translated` string — The translation of the `label` property for the request locale. Computed using the values in `label` and `label_translations` and the value of the request's `Accept-Language` header.
      - `amount` number, nullable — The sum of every line item on the payroll payable to this account. The sum is signed. Note that when it is negative, the CRA and Revenue Québec payment records created when a payroll is approved report zero rather than a negative amount, so the two figures differ.
      - `details` object, nullable — The same total split by who the money came from. `employee_amount` covers amounts withheld from workers, `employer_amount` covers amounts the employer owes on top of wages. The two add up to `amount`.
        - `employee_amount` number, nullable
        - `employer_amount` number, nullable

---

[API](https://skmtc.net/nmbr/apis/nmbr-api.md) · [All operations](https://skmtc.net/nmbr/apis/nmbr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nmbr/nmbr-api/revisions/c2532d856ea2/schema)