API Reference
Overview
Quick Start
API Authentication
API Error Codes
APIs
Checkout API
Checkout API
Order Details
User History
Prices
Get Prices
get
Product API
Product API
Coupons
Products
Licenses
Pay Links
Transactions
Payments
Subscription API
Subscription API
Plans
Users
Modifiers
Payments
One-off Charges
Alert API
Alert API
Webhooks

Get Prices

get
/2.0/prices

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...
  • Price changes may take 10 to 15 minutes in order to be reflected due to caching.
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
:
:
:
:
: