---
title: "List ROE SAT agreements"
method: GET
path: "/roe_sat_agreements"
tags: ["ROE SAT Agreements"]
---

# List ROE SAT agreements

`GET /roe_sat_agreements`

## Query parameters

- `business_entity_id` string
- `business_number` 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 (`"roe_sat_agreement"`).
    - `data` RoeSatAgreement
      - `business_entity` object
        - `id` string — The unique identifier of the object in Nmbr.
        - `object` string — The type of the object in Nmbr (`"business_entity"`).
      - `business_number` string — The CRA payroll account number (BN15) the agreement covers. ROEs issued under this number are filed with Service Canada automatically while the agreement is not revoked.
      - `business_legal_name` string — The client's legal name as written on the letter.
      - `signer_name` string — The person who signed the letter on the client's behalf.
      - `signer_title` string — The signer's job title.
      - `signed_on` string, date — The date written on the signed letter.
      - `revoked_at` string, dateTime, nullable — When the agreement was revoked. Null while the agreement is in effect.
      - `locale` 'en' | 'fr' — The language of the letter (en or fr).
      - `letter_was_uploaded` boolean — Whether the attached letter is the client's uploaded signed copy (true) or a copy generated from the recorded details (false). Download it from `/roe_sat_agreements/{id}/letter`.
      - `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.

---

[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/01cd9c45a923/schema)