Data types

The Paddle API uses JSON formatted data for requests and responses.

When making requests, specify application/json as your Content-Type. For example:

1
2
3
4
1curl -X POST https://api.paddle.com/customers
2  -H "Authorization: Bearer pdl_live_apikey_01gtgztp8f4kek3yd4g1wrksa3_q6TGTJyvoIz7LDtXT65bX7_AQO" 
3  -H "Content-Type: application/json" 
4  -d "{ "name": "Sam Miller", "email": "sam@example.com" }"

Paddle always sends responses as JSON. This includes errors as well as success responses.

Dates and times

All dates and times use the RFC 3339 format. For example:

Timezones

Paddle supports over 200 countries and territories, so dates and times are UTC.

Money

Monetary values are returned as strings in the lowest denomination for a currency. For example, the API returns values in cents for USD and pence for GBP.

Many currencies have two decimals, but this can vary. For example:

We recommend using a currency library to format monetary values to the correct number of decimals. They can also help you format values for different locales and currency standards, making sure that currency symbols are placed correctly and the correct decimal separator is used.

For convenience, the preview prices operation returns formatted_unit_totals and formatted_totals objects alongside objects that return totals in the lowest denomination for a currency. Formatted totals objects return values formatted for the country or region you're working with, including the currency symbol.

For a full list of supported currencies and their decimals, see Supported currencies

Custom data

You can add custom data to some entities in Paddle. Custom data must be valid JSON.

Related pages