What this operation supports in Chargebee
Searches for subscriptions matching specified criteria, such as status, plan/item, or customer.
Request behavior and expectations
Filtering by subscription status (active, in-trial, cancelled, paused) is a common way to scope this to exactly the subscriptions relevant to a given automation, like reaching out to customers whose trial is ending soon.
Operational considerations
Paginating through results rather than assuming a single page covers everything avoids missing subscriptions when a broad filter returns more matches than one page holds.
Use cases
Automations check for renewals, expirations, or churn indicators to drive next steps.