Sign in

v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB
credit-memos

Create a credit memo

Create a new credit memo.

With a credit memo, you can adjust the invoice amount owed by a customer.

See Credit memos in the Guides section for more information, sample requests, and responses.

post/v3/credit-memos

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

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 a credit memo response

idstring

BILL-generated ID of the credit memo. The value begins with ccr.

customerIdstring

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

referenceNumberstring

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

creditDatestring date

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

descriptionstring

Credit memo description

archivedboolean

Set as true if the credit memo is archived

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.

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.

amountnumber

Credit memo amount

appliedAmountnumber

Credit memo amount applied to invoices

salesTaxTotalnumber

Credit memo sales tax amount. The value is set based on salesTaxItemId.

salesTaxPercentagenumber

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.

createdTimestring date-time

Credit memo created time

updatedTimestring date-time

Credit memo updated time