get
/v1/credit_notes/preview/lines Retrieve a credit note preview's line items
GetCreditNotesPreviewLines
<p>When retrieving a credit note preview, you’ll get a <strong>lines</strong> property containing the first handful of those items. This URL you can retrieve the full (paginated) list of line items.</p>
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
amount | query | integer | no | 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_amount | query | integer | no | 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_at | query | integer | no | 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 | query | string | no | Type of email to send to the customer, one of `credit_note` or `none` and the default is `credit_note`. |
ending_before | query | string | no | 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. |
expand | query | string[] | no | Specifies which fields in the response should be expanded. |
invoice | query | string | yes | ID of the invoice. |
limit | query | integer | no | A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. |
lines | query | object[] | no | Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided. |
memo | query | string | no | The credit note's memo appears on the credit note PDF. |
metadata | query | object | no | Set of [key-value pairs](https://docs.stripe.com/api/metadata) 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_amount | query | integer | no | The integer amount in cents (or local equivalent) representing the amount that is credited outside of Stripe. |
reason | query | string | no | Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory` |
refund_amount | query | integer | no | 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. |
refunds | query | object[] | no | Refunds to link to this credit note. |
shipping_cost | query | object | no | 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_after | query | string | no | 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. |
Request Body
application/x-www-form-urlencoded Responses
200 Successful response.
default Error response.