---
title: "Update multiple credit memos"
method: PATCH
path: "/v3/credit-memos/bulk"
tags: ["credit-memos"]
---

# Update multiple credit memos

`PATCH /v3/credit-memos/bulk`

Update details about line items in multiple credit memos with one API request. You can also update other credit memo details.

You can use the PATCH operation to modify line item details, such as `amount`, `quantity`, and `description`. The credit memo line item `id` does not change with a PATCH operation.

## Headers

- `sessionId` string, nullable — API session ID generated with `/v3/login`
- `devKey` string, nullable — Developer key generated with your BILL developer account

## Request body

- UpdateCreditMemoWithIdRequestDto[]
  - `id` string, required — BILL-generated ID of the credit memo. The value begins with `ccr`.
  - `customerId` string — BILL-generated ID of the customer. The value begins with `0cu`.
  - `referenceNumber` string — User-generated credit memo number. This value can be in your chosen number scheme.
  - `creditDate` string, date — Credit memo issued date. This value is in the `yyyy-MM-dd` format.
  - `description` string — Credit memo description
  - `salesTaxItemId` string — BILL-generated ID of the `SALES_TAX` item. The value begins with `0ii`. The tax rate is applied to all the credit memo line items set as taxable. You can set up a `SALES_TAX` percentage item with `POST /v3/classifications/items`.
  - `payToChartOfAccountId` string — BILL-generated ID of the chart of accounts used when the credit memo is applied to an invoice payment. The value begins with `0ca`.
  - `payToBankAccountId` string — BILL-generated ID of the bank account used when the credit memo is applied to an invoice payment. The value begins with `bac`. **Note**: You can set only one of `payToChartOfAccountId` or `payToBankAccountId`.
  - `classifications` object — General ledger classifications information for the credit memo
    - `accountingClassId` string — BILL-generated ID of the accounting class. The value begins with `cls`.
    - `departmentId` string — BILL-generated ID of the department. The value begins with `0de`.
    - `jobId` string — BILL-generated ID of the job. The value begins with `job`.
    - `locationId` string — BILL-generated ID of the location. The value begins with `loc`.
  - `creditMemoLineItems` UpdateCreditMemoLineItemDto[] — Credit memo line item information
    - `id` string, required — BILL-generated ID of the credit memo line item. The value begins with `cci`.
    - `description` string — Credit memo line item description
    - `price` number — Credit Memo line item unit price. For a Credit memo in an international currency (not USD), this value is in the local currency.
    - `quantity` number — Credit memo line item unit quantity
    - `ratePercent` number — Credit memo line item rate percent. Use `ratePercent` to apply a discount or markup in your credit memo. BILL applies the discount to the sum of the `amount` values of all the line items above the `ratePercent` line item. **Note**: Use a separate line item to set a `ratePercent` for the credit memo. Set the `ratePercent` line item as the final line item. Do not set `price` and `quantity` in the line item when you set `ratePercent`. For example, let's say you have two line items in a credit memo with an `amount` sum of `$150`. If you create a third line item with `ratePercent` set as `-10`, a 10% discount (`$15`) is applied to the `amount` sum of `$150`.
    - `taxable` boolean — Set as `true` if the credit memo line item is taxable
    - `classifications` object — General ledger classifications information for the credit memo line item
      - `chartOfAccountId` string — BILL-generated ID of the chart of accounts. The value begins with `0ca`.
      - `accountingClassId` string — BILL-generated ID of the accounting class. The value begins with `cls`.
      - `departmentId` string — BILL-generated ID of the department. The value begins with `0de`.
      - `jobId` string — BILL-generated ID of the job. The value begins with `job`.
      - `locationId` string — BILL-generated ID of the location. The value begins with `loc`.
      - `itemId` string — BILL-generated ID of the item. The value begins with `0ii`.

## Response `200`

Update multiple credit memos response

- CreditMemoBulkResponseDto — Response Dto for bulk credit memo.
  - `creditMemos` CreditMemoResponseDto[] — List of credit memos
    - `id` string — BILL-generated ID of the credit memo. The value begins with `ccr`.
    - `customerId` string — BILL-generated ID of the customer. The value begins with `0cu`.
    - `referenceNumber` string — User-generated credit memo number. This value can be in your chosen number scheme.
    - `creditDate` string, date — Credit memo issued date. This value is in the `yyyy-MM-dd` format.
    - `description` string — Credit memo description
    - `archived` boolean — Set as `true` if the credit memo is archived
    - `salesTaxItemId` string — BILL-generated ID of the `SALES_TAX` item. The value begins with `0ii`. The tax rate is applied to all the credit memo line items set as taxable.
    - `payToChartOfAccountId` string — BILL-generated ID of the chart of accounts used when the credit memo is applied to an invoice payment. The value begins with `0ca`.
    - `payToBankAccountId` string — BILL-generated ID of the bank account used when the credit memo is applied to an invoice payment. The value begins with `bac`.
    - `amount` number — Credit memo amount
    - `appliedAmount` number — Credit memo amount applied to invoices
    - `salesTaxTotal` number — Credit memo sales tax amount. The value is set based on `salesTaxItemId`.
    - `salesTaxPercentage` number — Credit memo sales tax percentage. The value is set based on `salesTaxItemId`.
    - `status` 'FULLY_APPLIED' | 'NOT_APPLIED' | 'PARTIALLY_APPLIED' | 'IN_PROCESS' | 'UNDEFINED' — Credit memo status.
    - `createdTime` string, date-time — Credit memo created time
    - `updatedTime` string, date-time — Credit memo updated time
    - `creditMemoLineItems` CreditMemoLineItemResponseDto[] — Credit memo line item information
      - `id` string — BILL-generated ID of the credit memo line item. The value begins with `cci`.
      - `description` string — Credit memo line item description
      - `price` number — Credit memo line item unit price. For a credit memo in an international currency (not USD), this value is in the local currency.
      - `quantity` number — Credit memo line item unit quantity
      - `amount` number — Credit memo line item amount
      - `ratePercent` number — Credit memo line item rate percent
      - `taxable` boolean — Set as `true` if the credit memo line item is taxable
      - `classifications` object — General ledger classifications information for the credit memo line item
        - `chartOfAccountId` string — BILL-generated ID of the chart of accounts. The value begins with `0ca`.
        - `accountingClassId` string — BILL-generated ID of the accounting class. The value begins with `cls`.
        - `departmentId` string — BILL-generated ID of the department. The value begins with `0de`.
        - `jobId` string — BILL-generated ID of the job. The value begins with `job`.
        - `locationId` string — BILL-generated ID of the location. The value begins with `loc`.
        - `itemId` string — BILL-generated ID of the item. The value begins with `0ii`.
    - `classifications` object — General ledger classifications information for the credit memo
      - `accountingClassId` string — BILL-generated ID of the accounting class. The value begins with `cls`.
      - `departmentId` string — BILL-generated ID of the department. The value begins with `0de`.
      - `jobId` string — BILL-generated ID of the job. The value begins with `job`.
      - `locationId` string — BILL-generated ID of the location. The value begins with `loc`.

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

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