Data types
Make requests to the Paddle API in JSON. Paddle responds in JSON.
The Paddle API uses JSON formatted data for requests and responses.
When making requests, specify application/json as your Content-Type. For example:
cURL request
12341curl -X POST https://api.paddle.com/customers
2 -H "Authorization: Bearer bb4e69088ea07a98a90565ac610c63654423f8f1e2d48b39b5"
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:
| Time and date | RFC 3339 |
|---|---|
| 3:30pm on March 20th 2023 | 2023-03-20T15:30:00.00Z |
| 2am on January 12th 2024 | 2024-01-12T02:00:00.00Z |
| 8:50pm on October 12th 2024 | 2024-10-12T20:50:00.00Z |
Timezones
Paddle lets you sell globally in over 200 countries, so dates and times are UTC.
Money
Monetary values are returned as strings in the lowest denomination for a currency. For example, cents for USD and pence for GBP. For example:
| Currency | Decimals | Example | Value |
|---|---|---|---|
USD | 2 | $24.99 | "2499" |
JPY | 0 | ¥1000 | "1000" |
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
On this page
