Creates an item to be added to a draft invoice (up to 250 items per invoice). If no invoice is specified, the item will be on the next invoice created for the customer specified.
Parameters
- amountinteger
The integer amount in the smallest currency unit of the charge to be applied to the upcoming invoice. Passing in a negative
amountwill reduce theamount_on the invoice.due - currencyenum
Three-letter ISO currency code, in lowercase. Must be a supported currency.
- customerstring
The ID of the customer to bill for this invoice item.
- customer_
accountstring The ID of the account representing the customer to bill for this invoice item.
- descriptionstring
An arbitrary string which you can attach to the invoice item. The description is displayed in the invoice for easy tracking.
- metadatamap
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. - periodobject
The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have Stripe Revenue Recognition enabled, the period will be used to recognize and defer revenue. See the Revenue Recognition documentation for details.
- pricingobject
The pricing information for the invoice item.
More parameters
- discountableboolean
- discountsarray of objects
- invoicestring
- price_
dataobject - quantityintegerDeprecated
- quantity_
decimaldecimal string - subscriptionstring
- tax_
behaviorenumRecommended if calculating taxes - tax_
codestringRecommended if calculating taxes - tax_
ratesarray of strings - unit_
amount_ decimaldecimal string
Returns
The created invoice item object is returned if successful. Otherwise, this call raises an error.
curl https://api.stripe.com/v1/invoiceitems \ -u "sk_test_...sk_test_...:" \ -H "Stripe-Version: 2026-10-28.endive" \ -d customer={{CUSTOMER_ID}} \ -d "pricing[price]={{PRICE_ID}}"{ "id": "ii_1MtGUtLkdIwHu7ixBYwjAM00", "object": "invoiceitem", "amount": 1099, "currency": "usd", "customer": "cus_NeZei8imSbMVvi", "date": 1680640231, "description": "T-shirt", "discountable": true, "discounts": [], "invoice": null, "livemode": false, "metadata": {}, "parent": null, "period": { "end": 1680640231, "start": 1680640231 }, "pricing": { "price_details": { "price": "price_1MtGUsLkdIwHu7ix1be5Ljaj", "product": "prod_NeZe7xbBdJT8EN" }, "type": "price_details", "unit_amount_decimal": "1099" }, "proration": false, "quantity": 1, "quantity_decimal": "1", "tax_rates": [], "test_clock": null}Updates the amount or description of an invoice item on an upcoming invoice. Updating an invoice item is only possible before the invoice it’s attached to is closed.
Parameters
- amountinteger
The integer amount in the smallest currency unit of the charge to be applied to the upcoming invoice. If you want to apply a credit to the customer’s account, pass a negative amount.
- descriptionstring
An arbitrary string which you can attach to the invoice item. The description is displayed in the invoice for easy tracking.
- metadatamap
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. - periodobject
The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have Stripe Revenue Recognition enabled, the period will be used to recognize and defer revenue. See the Revenue Recognition documentation for details.
- pricingobject
The pricing information for the invoice item.
More parameters
- idstringRequired
- discountableboolean
- discountsarray of objects
- invoicing_
rulesenumPreview feature - price_
dataobject - quantityintegerDeprecated
- quantity_
decimaldecimal string - tax_
behaviorenumRecommended if calculating taxes - tax_
codestringRecommended if calculating taxes - tax_
ratesarray of strings - unit_
amount_ decimaldecimal string
Returns
The updated invoice item object is returned upon success. Otherwise, this call raises an error.
curl https://api.stripe.com/v1/invoiceitems/{{INVOICEITEM_ID}} \ -u "sk_test_...sk_test_...:" \ -H "Stripe-Version: 2026-10-28.endive" \ -d "metadata[order_id]=6735"{ "id": "ii_1MtGUtLkdIwHu7ixBYwjAM00", "object": "invoiceitem", "amount": 1099, "currency": "usd", "customer": "cus_NeZei8imSbMVvi", "date": 1680640231, "description": "T-shirt", "discountable": true, "discounts": [], "invoice": null, "livemode": false, "metadata": { "order_id": "6735" }, "parent": null, "period": { "end": 1680640231, "start": 1680640231 }, "pricing": { "price_details": { "price": "price_1MtGUsLkdIwHu7ix1be5Ljaj", "product": "prod_NeZe7xbBdJT8EN" }, "type": "price_details", "unit_amount_decimal": "1099" }, "proration": false, "quantity": 1, "quantity_decimal": "1", "tax_rates": [], "test_clock": null}Retrieves the invoice item with the given ID.
Parameters
- idstringRequired
Unique identifier for the object.
Returns
Returns an invoice item if a valid invoice item ID was provided. Raises an error otherwise.
curl https://api.stripe.com/v1/invoiceitems/{{INVOICEITEM_ID}} \ -u "sk_test_...sk_test_...:" \ -H "Stripe-Version: 2026-10-28.endive"{ "id": "ii_1MtGUtLkdIwHu7ixBYwjAM00", "object": "invoiceitem", "amount": 1099, "currency": "usd", "customer": "cus_NeZei8imSbMVvi", "date": 1680640231, "description": "T-shirt", "discountable": true, "discounts": [], "invoice": null, "livemode": false, "metadata": {}, "parent": null, "period": { "end": 1680640231, "start": 1680640231 }, "pricing": { "price_details": { "price": "price_1MtGUsLkdIwHu7ix1be5Ljaj", "product": "prod_NeZe7xbBdJT8EN" }, "type": "price_details", "unit_amount_decimal": "1099" }, "proration": false, "quantity": 1, "quantity_decimal": "1", "tax_rates": [], "test_clock": null}