Transaction for a subscription has more than the maximum number of line items
You can't make a change to a subscription that creates a related transaction with more than 100 items.
| Error Message | Subscription update results in a transaction that has more than the maximum number of line items. |
| Error Code | subscription_maximum_number_of_line_items_reached |
| Status Code | 400 |
Common causes
You're trying to add more than 100 recurring items to a subscription.
You're billing for changes on the next billing period, but there are already line items for previous changes or one-time charges scheduled to be billed on renewal. This results in the next transaction including more than 100 line items.
You're replacing too many recurring items on a subscription in one go, resulting in the next transaction including more than 100 line items.
Solutions
Reduce the number of recurring items on the subscription to 100 or fewer.
Get a subscription including
next_transactionto preview line items for the next transaction, including subscription changes and one-time charges that are scheduled to be billed.Use
prorated_immediatelyorfull_immediatelyas theproration_billing_modeto bill for changes immediately rather than adding them to the transaction created on renewal.