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:
12341curl -X POST https://sandbox-api.paddle.com/customers
2 -H "Authorization: Bearer bb4e69088ea07a98a90565ac610c63654423f8f1e2d48b39b5"
3 -H "Content-Type: application/json"
4 -d "{ "name": "George Oscar Bluth Jr.", "email": "gob@bluthcompany.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
When working with money, specify values in the lowest denomination of a currency. For example, use 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.