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 new recurring query parameter that you can use when working with the list prices operation to return either recurring prices or one-time prices.
GEThttps://api.paddle.com/prices
recurringboolean
Set to true to return only recurring prices; false to return only one-time prices.
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_periodis an object with details about how often the price should be billed. - One-time prices are those where the
billing_periodisnull.
You can use this when working with subscription items to determine which operation to use:
- When adding recurring prices, you should update
itemsagainst a subscription using the update a subscription operation. - When adding one-time charges, you should use the create a one-off charge for a subscription 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 using the API to start using the new recurring parameter.
