What's new?
We added a new recurring query parameter that you can use when working with the list prices operation to return either recurring prices or one-time prices.
/prices 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-time 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.
Summary of changes
| Entity | Field | Change | Type |
|---|---|---|---|
| List prices | recurring | + Added | Field |
| Filter to recurring or one-time prices. | |||