Just launched
We're actively working on new content and improvements to our documentation. We'd love to hear your thoughts, launch quick survey
Paddle Billing
Search

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:

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 dateRFC 3339
3:30pm on March 20th 20232023-03-20T15:30:00.00Z
2am on January 12th 20242024-01-12T02:00:00.00Z
8:50pm on October 12th 20242024-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:

CurrencyDecimalsExampleValue
USD2$24.992499
JPY0¥10001000

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