> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Filter subscriptions by collection mode

List only automatically-collected or manually-collected subscriptions.

---

## What's new?

We added a new `collection_mode` query parameter that you can use when working with [the list subscriptions operation](https://developer.paddle.com/api-reference/subscriptions/list-subscriptions.md) to return entities that match the specified collection mode.

{% api-endpoint method="GET" path="/subscriptions?collection_mode=automatic,manual"  %}

- **collection_mode** (string): Return entities that match the specified collection mode
{% /api-endpoint %}

## How it works

The new `collection_mode` query parameter lets you filter subscriptions by collection mode. For example, you can use it to return subscriptions that are [billed by invoice](https://developer.paddle.com/build/invoices/create-issue-invoices.md) (manually-collected).

It works in the same way as the `collection_mode` query parameter when [listing transactions](https://developer.paddle.com/api-reference/transactions/list-transactions.md).

## Next steps

This change is available in version `1` of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.

You can [list subscriptions](https://developer.paddle.com/api-reference/subscriptions/list-subscriptions.md) using the API to start using the new query parameters.
## Summary of changes

| Name | Type | Change | Entity | Description |
| --- | --- | --- | --- | --- |
| `collection_mode` | Field | added | List subscriptions | Filter by automatic or manual collection mode. |