---
title: "List remittance accounts"
method: GET
path: "/remittance_accounts"
tags: ["Remittance Accounts"]
---

# List remittance accounts

`GET /remittance_accounts`

## Query parameters

- `business_entity_id` string, required
- `category` union
  - 'ca_benefit_provider' | 'ca_provincial_government' | 'ca_tax_agency' | 'ca_union' | 'ca_workers_compensation'
  - string[]
- `has_payments` boolean
- `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[]
- `system_type` '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'
- `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_account"`).
    - `data` RemittanceAccount
      - `business_entity` object
        - `id` string — The unique identifier of the object in Nmbr.
        - `object` string — The type of the object in Nmbr (`"business_entity"`).
      - `source_tax_property` object
        - `id` string — The unique identifier of the object in Nmbr.
        - `object` string — The type of the object in Nmbr (`"tax_property"`).
      - `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 to which remittances are made for this account. This is used to determine how to remit payments for this account. Employer Health Tax (EHT) and Workers' Compensation (WCB) authorities are limited to one account, per province, per business entity; creating a second for an authority that already has one is rejected.
      - `is_default` boolean — When true, this account is used for auto-enrollment of new work-assignments, and work-assignments without an existing enrollment for this authority. Only one account per authority per business may be the default at a time.
      - `is_editable` boolean — When false, the account's `account_identifier` cannot be updated. Becomes false once the account is used on a non-draft payroll and an `account_identifier` is set; returns to true when every referencing payroll is reverted to draft or deleted.
      - `is_deletable` boolean — When false, the account cannot be deleted. Becomes false once the account is referenced by any non-draft payroll; returns to true when every referencing payroll is reverted to draft or deleted.
      - `linked_remittance_account` unknown
      - `category` 'ca_benefit_provider' | 'ca_provincial_government' | 'ca_tax_agency' | 'ca_union' | 'ca_workers_compensation', nullable
      - `label` string
      - `label_translations` Translations, nullable
        - `en` string
        - `fr` string
      - `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.
      - `account_identifier` string, nullable
      - `superseded_by` unknown
      - `superseded_on` string, date, nullable — The date this account was replaced by its successor. Null when no successor has been recorded.
      - `remitter_type` 'accelerated_threshold_1' | 'accelerated_threshold_2' | 'quarterly' | 'regular', nullable — The CRA remitter type for this account, which determines remittance due dates and reporting frequency. When null, falls back to the business entity's remitter type.
      - `remittance_management` 'automatic' | 'manual' — Whether remittances for this account are filed manually by the employer (`manual`) or handled automatically by Nmbr (`automatic`). Only accounts Nmbr can remit on your behalf (CRA, RQ, and Employer Health Tax authorities) may be set to `automatic`; all others are always `manual`.
      - `note` string, nullable
      - `address_line_1` string, nullable
      - `address_line_2` string, nullable
      - `city` string, nullable
      - `administrative_area` string, nullable
      - `province_code` string, nullable
      - `country_code` string, nullable
      - `postal_code` string, nullable
      - `has_payments` boolean
      - `current_enrollments_count` number, nullable
      - `pending_enrollments_count` number, nullable
      - `metadata` union — Additional data points for this account. The available fields depend on the account's `category`; `null` for categories that capture no metadata.
        - object
          - `last_payment_amount` string, decimal, nullable — The last payment made to the board before Nmbr takes over remittance, in dollars (e.g. `"1250.00"`).
        - object, nullable — Categories with no category-specific metadata. Omit the field or send `null`.
      - `created_at` string, dateTime — The date and time the object was created in Nmbr.
      - `updated_at` string, dateTime — The date and time the object was last updated in Nmbr.

## Changes

- **2026-08-29** `29c2d6ac7131` — 4 info
  - added the enum value `superseded_by` to the property `items/` of the `query` request parameter `expand`
  - added the optional property `data/items/data/allOf[subschema #1: Remittance Account]/superseded_by` to the response with the `200` status
  - added the optional property `data/items/data/allOf[subschema #1: Remittance Account]/superseded_on` to the response with the `200` status
  - added `subschema #5: With superseded_by expanded` to the `data/items/data` response property `anyOf` list for the response status `200`
- **2026-08-19** `12dd3b52211d` — 1 info
  - added the optional property `data/items/data/anyOf[subschema #2: With business_entity expanded]/business_entity/data/accounting_settings/journal_entry_dimensions` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/nmbr/apis/nmbr-api/changes/remittance_accounts/get.md)

---

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