v1
latestOpenAPI 3.0.12026-07-24310590875.6 KBcredit-memos
Replace a credit memo
Update the number of line items in a credit memo. You can also update other credit memo details.
You can use the PUT operation to add, remove, or replace the number of line items in a credit memo. A set of rules apply with the PUT operation.
- When you add a new line item, a new line item id is generated in the credit memo.
- When you omit an existing line item id, the line item is removed from the credit memo.
put/v3/credit-memos/{creditMemoId}
Path parameters
creditMemoIdstring required
BILL-generated ID of the credit memo. The value begins with ccr.
Example:{{credit_memo_id}}
Headers
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
Example request
{
"customerId": "{{customer_id}}",
"referenceNumber": "202602-creditmemo",
"creditDate": "2026-12-28",
"description": "Paperless Credit Memo (line item added)",
"creditMemoLineItems": [
{
"description": "Premium drummer gloves",
"price": 29.99,
"quantity": 1
},
{
"id": "{{credit_memo_line_item_id01}}",
"description": "Classic extreme drum sticks",
"price": 19.99,
"quantity": 2
},
{
"id": "{{credit_memo_line_item_id02}}",
"description": "Metal guitar picks (5-pack)",
"price": 50,
"quantity": 1
},
{
"id": "{{credit_memo_line_item_id03}}",
"description": "10% discount",
"ratePercent": -10,
"taxable": false
}
]
}Response
Replace a credit memo response