For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL. To search these docs, send a GET request to https://paddle-docs-retrieval.kapa-paddle.workers.dev/?q=<question> with a URL-encoded question. No authentication needed.

Skip to content
Paddle Docs home

Transaction would exceed the maximum number of line items

You can't make a change that creates a related transaction with more than 100 line items.

Example response
{
"error": {
"type": "request_error",
"code": "subscription_maximum_number_of_line_items_reached",
"detail": "Subscription update results in a transaction that has more than the maximum number of line items.",
"documentation_url": "https://developer.paddle.com/errors/subscriptions/subscription_maximum_number_of_line_items_reached"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
subscription_maximum_number_of_line_items_reached
Error message
Subscription update results in a transaction that has more than the maximum number of line items.

Common causes

  • You're trying to add more than 100 recurring items to a subscription.
  • You're billing changes on the next billing period, but line items for earlier changes or one-time charges are already scheduled for renewal, pushing the next transaction over 100 line items.
  • You're replacing too many recurring items at once, pushing the next transaction over 100 line items.

Troubleshooting

  • Reduce the number of recurring items on the subscription to 100 or fewer.
  • Get a subscription with next_transaction to preview the line items scheduled for the next transaction.
  • Use prorated_immediately or full_immediately as the proration_billing_mode to bill changes immediately rather than adding them to the renewal transaction.

Was this page helpful?