---
title: "Create EI/CPP balance report"
method: POST
path: "/reports/ei-cpp-balance"
tags: ["Reports"]
---

# Create EI/CPP balance report

`POST /reports/ei-cpp-balance`

When an EI/CPP Balance Report is created, the report content will be created asynchronously. It may then be retrieved from the GET endpoint using an "accept: text/csv" header.

To filter which payrolls should be included in the report, you must pass a filters object here, which must contain: `year`: The year to generate the report for.

## Request body

- object
  - `business_entity_id` string — Optional, the business entity to limit the report to.
  - `filters` object — Options to allow filtering the content of the report
    - `year` integer

## Response `201`

Created

- object
  - `id` string — The unique identifier of the object in Nmbr.
  - `object` string — The type of the object in Nmbr (`"report"`).
  - `data` Report
    - `type` 'cra-remittance' | 'ei-cpp-balance' | 'ei-qpp-qpip-balance' | 'employer-health-tax' | 'journal-entry' | 'journal-entry-line-item' | 'liability' | 'payroll-register' | 'rl1-preview' | 'rq-remittance' | 't4-preview' | 'vacation-accrual' | 'workers-compensation' | 'year-end-forms' | 'year-to-date'
    - `business_entity` unknown
    - `pay_schedule` unknown
    - `payroll` object
      - `id` string — The unique identifier of the object in Nmbr.
      - `object` string — The type of the object in Nmbr (`"payroll"`).
    - `filters` object, nullable
    - `has_results` boolean
    - `format` 'csv' | 'pdf' | 'xlsx', nullable — The output format set at creation for `/download`. One of `csv` or `xlsx`. `null` when no format was specified — required to use `/download`.
    - `sheet` string, nullable — The sheet selected at creation for multi-sheet reports (e.g. `summary` or `detail` for Payroll Register). `null` when the report has a single sheet or no sheet was specified.
    - `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)