v52

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-015891,4406.1 MB

Retrieve a credit note preview's line items

When retrieving a credit note preview, you’ll get a lines property containing the first handful of those items. This URL you can retrieve the full (paginated) list of line items.

get/v1/credit_notes/preview/lines

Query parameters

amountinteger

The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of amount, lines, or shipping_cost must be provided.

credit_amountinteger

The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.

effective_atinteger

The date when this credit note is in effect. Same as created unless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the credit note PDF.

email_type'credit_note' | 'none'

Type of email to send to the customer, one of credit_note or none and the default is credit_note.

ending_beforestring

A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.

expandstring[]

Specifies which fields in the response should be expanded.

invoicestring required

ID of the invoice.

limitinteger

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.

amountinteger
descriptionstring
invoice_line_itemstring
metadataobject
quantityinteger
type'custom_line_item' | 'invoice_line_item' required
unit_amountinteger
unit_amount_decimalstring decimal

Line items that make up the credit note. One of amount, lines, or shipping_cost must be provided.

memostring

The credit note's memo appears on the credit note PDF.

metadataobject

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

out_of_band_amountinteger

The integer amount in cents (or local equivalent) representing the amount that is credited outside of Stripe.

reason'duplicate' | 'fraudulent' | 'order_change' | 'product_unsatisfactory'

Reason for issuing this credit note, one of duplicate, fraudulent, order_change, or product_unsatisfactory

refund_amountinteger

The integer amount in cents (or local equivalent) representing the amount to refund. If set, a refund will be created for the charge associated with the invoice.

amount_refundedinteger
refundstring
type'payment_record_refund' | 'refund'

Refunds to link to this credit note.

shipping_ratestring

When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of amount, lines, or shipping_cost must be provided.

starting_afterstring

A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.

Response

Successful response.

has_moreboolean required

True if this list has another page of items after this one that can be fetched.

object'list' required

String representing the object's type. Objects of the same type share the same value. Always has the value list.

urlstring required

The URL where this list can be accessed.