Paddle Billing

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


Paddle lets you sell globally in over 200 countries, so dates and times are UTC.


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


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