Paddle Billing
Search

See the complete price entity for subscription items

The price object returned for subscription items now includes all fields against the price entity, rather than a subset. The returned price is a snapshot of the price at the time it was added to the subscription.

What's new?

We updated the subscription entity, so that subscription.items[].price now returns all fields against a price entity, rather than a subset of fields.

How it works

When working with subscriptions, Paddle returns a price object for each item. You can use this to get information about a price without making another call to the Paddle API.

Previously, we returned a subset of fields against a price entity for subscription items. With this release, we return the complete price entity. This makes the behavior of subscription items consistent with other parts of the Paddle API, and means you have all the information about the price when working with subscription entities.

The price returned is a snapshot of the price at the time it was added to the subscription. If you update a price entity after it's added to a subscription, the price object returned for a subscription item doesn't include any changes since you added it.

Summary of changes

This is a summary of the changes to fields in the Paddle API and webhooks.

subscription.items[].price now returns a price entity. The following fields were not previously included:

FieldChange
subscription.items[].price.typeNew
subscription.items[].price.nameNew
subscription.items[].price.unit_price_overridesNew
subscription.items[].price.custom_dataNew
subscription.items[].price.statusNew
subscription.items[].price.quantityNew
subscription.items[].price.import_metaNew
subscription.items[].price.created_atNew
subscription.items[].price.updated_atNew

Example

This example is a response for the get 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 subscriptions using the API to check out the changes to subscription items.

Learn more