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

# Filter to see recurring and one-time prices

Filter to see recurring or one-time prices when using the list prices operation.

---

## What's new?

We added a new `recurring` query parameter that you can use when working with [the list prices operation](https://developer.paddle.com/api-reference/prices/list-prices.md) to return either recurring prices or one-time prices.

<!-- 
TODO: change this to ref the model in the api-specifications repo once finalized 
$ref: oas#/components/parameters/ListPricesQueryParams.recurring
-->
{% api-endpoint method="GET" path="/prices"  %}

- **recurring**: Set to `true` to return only recurring prices; `false` to return only one-time prices.
{% /api-endpoint %}

## How it works

The new `recurring` query parameter lets you filter prices to see only recurring prices or only one-time prices.

* Recurring prices are those where the `billing_period` is an object with details about how often the price should be billed.
* One-time prices are those where the `billing_period` is `null`.

You can use this when working with subscription items to determine which operation to use:

* When adding recurring prices, you should update `items` against a subscription using the [update a subscription operation](https://developer.paddle.com/api-reference/subscriptions/update-subscription.md).
* When adding one-time charges, you should use the [create a one-time charge for a subscription](https://developer.paddle.com/api-reference/subscriptions/create-one-time-charge.md) operation.

## 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 prices](https://developer.paddle.com/api-reference/prices/list-prices.md) using the API to start using the new `recurring` parameter.
## Summary of changes

| Name | Type | Change | Entity | Description |
| --- | --- | --- | --- | --- |
| `recurring` | Field | added | List prices | Filter to recurring or one-time prices. |