Get Prices

get

/2.0/prices

Retrieve prices for one or multiple products or plans

Paddle's 2.0 Pricing API supports:

Batch price lookup: retrieve the prices of multiple products in a single API call
Custom localization: pass the visitor IP or country code you want us to localize
Display original and discounted price
Coupon discounts
Server-to-server requests*
Pricing for one-time and subscription products

If you would like to call this API from the front-end, please follow the example implementation here - do not pass in the customer_country or customer_ip parameter, as the API will automatically localize the price and currency according to the user's location.

Example Request

preparing...

Usage Notes

Price changes may take 10 to 15 minutes in order to be reflected due to caching.

Request

Query Parameters

product_ids

string

required

A comma-separated list of product (or subscription plan) IDs to return prices for. Please note that the product needs to be fully set-up in the dashboard (checkout link is available); Failing to do so will result in the API not returning the product prices.

Style:

unspecified

Match pattern:

\d+

calculate_recurring_discounts

boolean

Whether Paddle should return discounted prices for recurring products. Chooses the discount that gives the best upfront discount.

Default:

false

Style:

unspecified

coupons

string

A comma-separated list of coupon codes to apply to the product prices.

Style:

unspecified

customer_country

string

A two character ISO country code (eg. GB) for localized pricing. See Supported Countries.

Style:

unspecified

Match pattern:

[A-Z]{2}

customer_ip

string

An IP address of the customer to return localized pricing for.

Style:

unspecified

Parameters