Create multiple credit memos

Create multiple credit memos with one API request. You can create up to 50 credit memos with one POST /v3/credit-memos/bulk request.

sessionIdstring nullable

API session ID generated with /v3/login

Example:{{session_id}}

devKeystring nullable

Developer key generated with your BILL developer account

Example:{{developer_key}}

Request body

customerIdstring required

BILL-generated ID of the customer. The value begins with 0cu.

referenceNumberstring required

User-generated credit memo number. This value can be in your chosen number scheme.

creditDatestring date required

Credit memo issued date. This value is in the yyyy-MM-dd format.

descriptionstring

Credit memo description

salesTaxItemIdstring

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.

payToChartOfAccountIdstring

BILL-generated ID of the chart of accounts used when the credit memo is applied to an invoice payment. The value begins with 0ca.

payToBankAccountIdstring

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.

Example request

[
  {
    "customerId": "{{customer_id}}",
    "referenceNumber": "202602-creditmemo",
    "creditDate": "2026-12-28",
    "creditMemoLineItems": [
      {
        "description": "Classic extreme drum sticks",
        "price": 14.99,
        "quantity": 2
      },
      {
        "description": "Metal guitar picks (5-pack)",
        "price": 50,
        "quantity": 1
      },
      {
        "description": "10% discount",
        "ratePercent": -10
      }
    ],
    "description": "Paperless Credit Memo"
  }
]

Response

Create multiple credit memos response

v1

Create multiple credit memos

Headers

Request body

Example request

Response