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

# Filter subscriptions by ID when listing

Pass a list of subscription IDs when listing subscriptions to return subscriptions that match.

---

## What's new?

We added a new `id` 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 IDs specified.

{% api-endpoint method="GET" path="/subscriptions"  %}

- **id** (array[string]): Return only the IDs specified. Use a comma-separated list to get multiple entities
{% /api-endpoint %}

## How it works

The new `id` query parameter lets you filter [subscriptions](https://developer.paddle.com/api-reference/subscriptions/overview.md) by ID. You can pass a comma-separated list, and Paddle returns any entities that match.

`id` is already supported by other list endpoints, so this release makes the `/subscriptions` endpoint consistent with the rest of the Paddle API.

## 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 |
| --- | --- | --- | --- | --- |
| `id` | Field | added | List subscriptions | Filter by one or more subscription IDs. |